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Preface 


The EREP User's Guide and Reference applies to all versions of EREP, up to and 
including EREP Version 3, Release 3 and all later releases of the EREP program. 


The operating systems under which EREP can run are: 


e DOS/VS, DOS/VSE, and VSE/Advanced Functions — known collectively in 
this book as the VSE systems. 


e VSI, VS2, MVS/370, and MVS/XA — known collectively in this book as the 
MYVS systems. 


e VM/370, VM/SP, VM/SP/HPO, and VM/XA — known collectively in this 
book as the VM systems. 


If EREP 3.3 is not installed on your system, some of the information in this book 
will not apply to your installation. You can find out which level of EREP your 
system supports by checking the release number of the EREP tape last installed; 
the release number is in the System Control Programming Specifications, which 
accompany the EREP tape. Or, for EREP 2.3 and later versions, the TOURIST 
output shows which release of EREP is running. 


Note: New releases of EREP are always “downward compatible.” 


That is, the latest version of EREP will always run on your system. It will also 
include new functions that you can only use if you have the latest version of your 
operating system; but old functions, generally speaking, are not eliminated. The 
same is true of this book, although some very old versions of EREP (for example, 
IFCEREPO) are no longer supported. 
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Who This Book is For J 
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This book is for the people who manage and maintain the data processing equip- 
ment in a System/370 installation: 


e@ The system programmer, who must set up and run EREP 


e The IBM customer engineer (CE), who must use the EREP reports to diag- 
nose problems in the installation’s hardware devices. 


e The IBM programming service representative (PSR), who is called in when 
there is a problem with the running of EREP. 


It is also for anyone who wants to find out what EREP is and how it works. 


When reading this book, you will find a working knowledge of the operating 
system EREP is to run under very helpful; familiarity with its job control and 
entry language is also helpful, but not necessary. 


Because your requirements differ according to what you are trying to do, this 
book contains two kinds of information: 


1. Introductory and explanatory information about EREP, and detailed process 
information, for the person who may not know how to set up a job to run 
EREP. This is the user’s guide. 


2. Reference information in quick-look-up format — for the person who is 2 


familiar with EREP and the process of setting it up, but who wants to check 
out syntax or message wording or coding rules. 
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What and Where 


Organization and Contents 


The book has four parts: the user’s guide information is in Part 1 and Part 2; the 
reference information is in Part 3 and Part 4. 


Each of the four parts is made up of several chapters, which contain the following 
information: 


Part 1, “Planning for EREP” is the introduction to EREP. 


Chapter 1, “Introduction to EREP” is a brief explanation of what EREP 
is and what it does. 


Chapter 2, “EREP Reports” describes the EREP reports in some detail, 
including examples of the different types of reports. It also includes a 
checklist you can use when planning your EREP run. 


Part 2, “Setting Up and Running EREP” describes in detail what you have 
to do to run EREP under each of the S/370 operating systems. 


Chapter 3, “Setting Up EREP” 1s a general introduction to the way 
EREP works with an operating system. It includes sections on managing 
your error data for EREP, on automating your EREP procedures, and on 
modifying an EREP job. 


Chapter 4, “Running EREP” presents sample procedures that run EREP 
under each of the three system control programs, followed by descriptions 
of the required system controls and usage notes. 


Chapter 5, “Correcting Coding Problems” describes the possible reasons 
for problems with EREP processing or output and the ways you can 
correct those problems. 


Part 3, “Reference Information” is the first half of the reference section of 
the book. It includes: 


Chapter 6, “Introduction to EREP Controls,” which explains the presen- 
tations that follow. 


Chapter 7, “EREP Parameters,” which presents the syntax and coding 
rules for all the EREP keyword parameters. 


Chapter 8, “EREP Control Statements,” which presents the format and 
coding rules for the EREP control statements. 


Chapter 9, “CPEREP Operands - Syntax and Coding,” which presents 
syntax and specific information about EREP controls as CPEREP oper- 
ands. 


Chapter 10, “Error Records for EREP,” which introduces each type of 


error and operational record that EREP uses, showing its format and 
what it contains. 
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— Chapter 11, “EREP Messages,” which lists all the IFC-prefixed messages 


as they appear in EREP output, with explanations and recommended 
responses. 


— Chapter 12, “Summary of Tables and Charts,” which contains several 
tables and figures to be used for quick reference. Also included are such 
problem determination aids as the EREP return codes, standard problem 
determination tables, and the DEBUG parameter. 


Part 4, “Product-Dependent Information” is the second half of the reference 
section of the book. It contains information specific to particular IBM 
machines and device types supported by EREP; information that does not 


apply to all users of EREP but is important to the installations that have the * 


devices. The product-dependent information is presented by product group, 


as follows: 


— Chapter 
— Chapter 
— Chapter 
— Chapter 
— Chapter 
— Chapter 
— Chapter 


13, 
14, 
15, 
16 
17 
18, 
19 


w 


w 


w 


— Chapter 20, 
— Chapter 21, 
— Chapter 22, 
— Chapter 23, 
— Chapter 24, 


“Card Readers and Punches” 
“Consoles and Displays” 
“Direct-Access Storage Devices (DASD)” 
“Diskette Unit” 

“Magnetic Tape Drives” 
“OCR/MICR devices” 

“Printers” 

“Processors (CPUs)” 

“Punched Tape Devices” 
“Teleprocessing (TP) Devices” 
“Other Devices” 

“System Control Programs (SCPs)” 


Finally, the book also includes a Glossary of terms, a list of Abbreviations 
used in the EREP reports, and a Bibliography of the IBM publications men- 
tioned in the EREP User's Guide or associated with the use of EREP. 
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How To Use This Book 


Here are some suggestions on how to get the most out of the information in the 
EREP User's Guide and Reference. 


Before You Start to Set Up an EREP Run 


If you are a first-time user of EREP, you should read Chapter 1 and 
Chapter 2, to get an idea of how EREP works and what you have to do to 
run it, and to familiarize yourself with the EREP reports. 


Then, go on to Chapter 3 for a general introduction to running EREP under 
an operating system, and for information on managing error data for EREP 
— a very important item. 


If you are experienced as an EREP user, you may review the annotated 
sample EREP runs in Part 2, to see how a no-frills EREP run would be set 
up, and perhaps to run the sample code as is before tailoring it to your instal- 
lation. 


As You Set Up Your EREP Run 


Read and follow the procedures recommended for your operating system 
control program (SCP), and illustrated in the annotated samples in 
Chapter 4. 


Use the information in Chapter 5 and the messages in Chapter 11 as needed 
during the process of setting up and testing your EREP run. 


Use the reference information in Part 3 for quick checks on syntax or other 
requirements. You may also need to refer to Part 4 for information specific 
to one or more devices or products in your installation. 


After Your EREP Run is Set Up 


Read Chapter 2 for insights into the way EREP edits the records for its 
reports. 


Read Chapter 3 for a general discussion of the ways to modify an EREP run 
or automate the EREP run. 


Use the tables and charts in Chapter 12 to refresh your memory of how the 
EREP parameters and controls work. 


See Chapter 10 to check on the formats and expected contents of the records 
used for EREP reports. 


The table on the following pages gives you more specific pointers into the book 
according to what you need to do. 
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WHAT YOU WANT TO DO 


Get a general idea about EREP 


Decide which reports to run 


Manage your error data for EREP 


Create control statements for your 
hardware configuration 


Create an EREP Run: 


Figure 1-1 (Part 1 of 2). 


Vill 


General information 


Under VSE: 
Sample JCS procedure 
Required system controls (JCS) 
Storage requirements 
Notes 


Under MVS: 
Sample JCL procedure 
Required system controls (JCL) 
Storage requirements 
Notes 


Under VM: 
Sample procedure 
Required System Controls 
Storage requirements 
Notes 
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WHERE TO LOOK 


Chapter 1, “Introduction to EREP” 
Chapter 2, “EREP Reports” 


Chapter 2, “EREP Reports” 


Figure 12-3 in Chapter 12, “Summary of Tables and Charts” 


Chapter 3, “Setting Up EREP” 


Chapter 8, “EREP Control Statements” 


Chapter 3, “Setting Up EREP” on page 3-1 


“Running EREP under VSE” on page 4-2 
“VSE System Controls” on page 4-14 
“VSE Storage Requirements” on page 4-16 
“VSE Notes” on page 4-19 


“Running EREP under MVS” on page 4-20 
“MVS System Controls” on page 4-32 
“MVS Storage Requirements” on page 4-34 
“MVS Notes” on page 4-36 


“Running EREP under VM” on page 4-38 
“VM System Controls” on page 4-49 
“Defining Files for CPEREP” on page 4-49 
“VM Notes” on page 4-51 





Where to Find Information in this Book 


WHAT YOU WANT TO DO WHERE TO LOOK 


Find out what went wrong with your 
EREP run: 


In general Chapter 5, “Correcting Coding Problems” 


Under VSE “VSE Notes” on page 4-19 
“Information about the VSE SCP” on page 24-2 


Under MVS “MVS Notes” on page 4-36 
“Information about the MVS SCP” on page 24-5 


Under VM “VM Notes” on page 4-51 
“Information about the VM SCP” on page 24-8 


Using EREP messages Chapter 11, “EREP Messages” 


Run EREP automatically “Automating the Running of EREP” on page 3-8. 


Review the syntax for an Chapter 7, “EREP Parameters” 
EREP parameter “Syntax Rules and Conventions” on page 6-1. 


Change an EREP job to get a “Modifying Your EREP Run” on page 3-8. 
different report 


Find out if EREP supports a device | Part 4, “Product-Dependent Information” 
(Look under the device type within the product group.) 





Figure 1-1 (Part 2 of 2). Where to Find Information in this Book 
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Part 1. Planning for EREP 


How to Use Part 1 


This part of the EREP User's Guide tells about the EREP program — what it is, 
what it does, how it works. 


If you are interested in learning all about EREP, you can start at the beginning 
and read Part | in its entirety. 


If you only want to learn about certain aspects of EREP — what it requires of a 
user, for example, or what kind of output to expect — use the Section Table of 
Contents to locate what you want to read. 


And, if you want to see a list of the questions you should ask yourself before and 
while you set up your EREP run, see “A Planning Checklist” on page 2-95. 


Reference information is in Part 3. 
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Chapter 1. Introduction to EREP 


| 


The purpose of EREP, the Environmental Record Editing and Printing program, 
is to help the IBM Service Representative manage and maintain your data proc- 
essing installation. It is a diagnostic aid — an application program that runs 
under all three of the IBM System/370 operating systems. 


How Does EREP Work? 


EREP reads error and other environmental records generated by hardware and 
software, edits the records, and produces printed reports at your request. The 
reports show how things are — with the entire installation, with an I/O subsystem, 
with an individual device. The error and environmental records are the basis for 
the reports. 


Where Do the Records Come From? 


The operating system creates records from data captured by hardware or software 
whenever an error or other noteworthy event occurs — for example, a read error 
on a direct-access device or tape volume; or a machine check on a processor; or 
an IPL of the operating system. 


Where Do the Records Go? 


Each operating system includes error recovery procedures that write the records 
onto the system error recording data set (ERDS). 


The ERDS goes by different names in the various operating systems: in the VSE 
systems, its symbolic name is SYSREC; in MVS, it is SYS1.LOGREC; in VM, it 
is not a data set but the error recording area. Figure 1-1 on page 1-2 represents 
the ERDS as initialized by the operating system. 
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Figure 1-1. ERDS — The Error Recording Data Set, Initialized 


What Does EREP Do with the Records? J 


When you run EREP, it reads records directly from the ERDS and processes 
them to produce the report you have requested.! EREP processing includes: 


e Filtering the records through the selection parameters set up (or implied by 
default) for the requested report 


e Sorting and formatting the records for the report 
e Counting the different kinds of records used in the report 


e Copying the records onto a separate output data set, if you requested it. 


1 You do not have to request a report when you run EREP; you can also use it just ' 
to move the records from the ERDS to another data set. See “The History Data 2.) 
Set” on page 1-6 and “Managing Error Data” on page 3-1 for more information. 


1-2 EREP User’s Guide 


C 


How Do You Run EREP? 


Introduction 


You run EREP by executing the program named IFCEREP1, accompanied by 
various parameters and controls. The parameters and controls tell EREP what 
you want it to do. 


You execute the EREP program differently depending on which operating system 
you want to run it under. Following are brief summaries of how this is done; 
more detailed information is in Part 2, “Setting Up and Running EREP.” 


Under the VSE systems, you set up a JCS job, defining input and output data 
sets using TLBL or DLBL statements, and the necessary logical units using 
ASSGN statements. You list your EREP controls as instream data to be read 
from the SYSIPT logical unit, and submit the job. 


Under the MVS systems, you set up a JCL job, defining input and output 
data sets using DD statements, and including your EREP parameters on the 
EXEC statement or as SYSIN instream data. Other EREP controls are 
SYSIN instream data. 


Under VM, you define the input and output files using FILEDEFs and then 
issue the CPEREP command from the CMS environment. You can enter the 
CPEREP and EREP operands individually or together, depending on which 
CMS interface you choose to use. 


What Output Does the EREP Program Produce? 


Each time you run EREP, you can get three things: 


I. 


z: 


2. 


A listing of messages and other program information — the TOURIST output 
A printed report — one of the EREP reports 


A data set containing the records that passed filtering for the report — the 
history data set. 


The first of these is automatic; you always get the TOURIST output. The second 
and third items you control with EREP parameters included when you execute the 
EREP program. 
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The TOURIST Output 


The EREP Reports 
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While it is running, EREP puts valuable information about what it has done into 
a separate data set, named TOURIST.? The contents of the TOURIST data set 
are printed automatically at the end of the EREP run, unless you change the 
output class. 


The TOURIST output shows exactly which parameters, including defaults, EREP 
applied to the input records to produce the report; and the number of records 
actually processed for the report. It also shows how EREP has interpreted any 
control statements you set up for the report. If the program has issued any mes- 
sages during its processing, they appear in the TOURIST output. These are the 
same messages that are in Chapter 11, “EREP Messages,” in Part 3 of this book. 


You have to define the TOURIST data set to your system before running EREP. 
The process is described in “Defining Data Sets for EREP” on page 1-15. 


An example of TOURIST output is in Chapter 12, “Summary of Tables and 
Charts.” 


The main reason to run EREP is to get one of the EREP reports. Each EREP 
run can produce one of several different kinds of reports to help you monitor and 
maintain your installation’s I/O devices, controllers, channels, and processors. 


Figure 1-2 on page 1-5 shows the general report types EREP produces using the 
records from the ERDS. 


How Do You Get a Report? You request an EREP report by coding one of the 
report parameters, shown in Figure 1-5 on page 1-10. You tailor the report to 
contain the information you need to see by including EREP selection parameters, 
shown in Figure 1-6 on page 1-11.: You can use only one of the report parame- 
ters each time you execute the EREP program. However, some of the reports 
have several parts, so you can generate a lot of output. Unless you specifically 
ask for no printed report, EREP produces some kind of report output for each 
run, writing it to the EREPPT data set. 


2 In the VSE systems, the TOURIST messages are written to the SYSLST logical 
unit. For the sake of simplicity, we refer to the messages as the TOURIST output 
and to the data set/logical unit as the TOURIST data set throughout this book. 
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Figure 1-2. EREP Processing Produces Reports from ERDS Records 


What Kinds of Reports Does EREP Produce? Most of the EREP reports summa- 
rize error-record data within various groupings. Others give you quite specific 
information about the error records. Listed from most general to most specific, 
the reports are: 


System Summary 

Trends report 

Event History 

System Exception reports, including 

— System Error Summary 

— Subsystem Exception reports for processors, channels, DASD and tape 
devices 

— A series of summaries of the records, analyzed according to different cri- 
teria, for DASD and tape subsystems 

e Threshold Summary for some tape devices 

@ Detail (PRINT) Reports, including: 

— Detail Summaries of selected records 

— Data Reduction reports for specific I/O devices 

— Detail Edits of selected records 


All of these report types are discussed in more detail in various places in this 
book; see Chapter 2, “EREP Reports” for a start. 


You must define the output data set named EREPPT before running EREP to 
produce a report. The EREPPT data set holds the report until it is printed. See 
“Defining Data Sets for EREP” on page 1-15 and the sections on system controls 
in Part 2 for further details. 
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Introduction 


What If You Need More Than One Report? You run EREP again, requesting 
another report. EREP users often set up a group of jobs (or commands, if EREP 
is to run under VM) that execute the EREP program several times to produce a 
collection of reports. This group of EREP jobs is then run on a regular basis, 
giving a continuous picture of the performance of the installation’s hardware and 
software systems. Part 2 of this book shows samples of such job streams. 


The History Data Set 
Besides requesting a report, you can also use EREP to copy (or “accumulate”) the 
records from the ERDS to another output data set — the history data set. 
Figure 1-3 adds the history data set to the EREP output. 
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Figure 1-3. EREP Processing Produces a History Data Set 


You define the output history data set as the ACCDEV output data set} before 
executing the EREP program. See “Defining Data Sets for EREP” on page 1-15. 


You can have EREP accumulate the records even when it doesn’t produce a 


report; this is the way you create a working copy of the ERDS. The process is 
described in “Managing Error Data” on page 3-1. 


3 The VSE systems use different control statements to define the input and output 
data sets for EREP; they are described in “VSE System Controls” on page 4-14. 
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Introduction 


Using the History Data Set as Input for EREP: After having EREP accumulate 
the records onto the output data set defined by the ACCDEV DD statement, you 
can then use the records as input for another EREP run, instead of or in addition 
to the ERDS. In this case, you redefine the data set in your job controls as the 
ACCIN input data set. It is now an input history data set. “Defining Data Sets 
for EREP” on page 1-15 has more information about ACCIN, and “HIST” in 
Chapter 7, “EREP Parameters” has more information about history input. 


Other Ways You Can Use a History Data Set: You can use EREP’s accumu- 
lation function to control and maintain your error data for EREP. Some of the 
possibilities are: 


Before running any reports at all, you can copy the records from the ERDS 
to another data set and clear the ERDS so it can hold new records created 
while the EREP reports are being run. The second data set becomes the 
history input for the EREP reports, and all the reports are run against the 
same set of input records. This is described in “Managing Error Data” on 
page 3-1. 


After running all the reports for a given day or week, you can copy the 
records from the history data set onto yet another output data set, which 
becomes a weekly — or monthly — history data set, holding all the records 
used for EREP reports for the period. If you run a Trends report against this 
updated history data set at regular intervals, you have a good overall picture 
of the frequency of errors in your installation. The sample EREP runs for 
your operating system in Chapter 4, “Running EREP” show this sequence of 
processing. 


You can merge the records from a history data set and the ERDS to get a 
report that uses all the records collected on the history data set plus the latest 
records on the ERDS. For more information, see the description of the 
MERGE parameter in Chapter 7, “EREP Parameters.” 


If your installation runs more than one operating system, one for for each 
system. You can copy the records from one ERDS onto a history data set 
that you then merge with the ERDS from the system EREP is to run under. 
Thus, you get EREP reports that use all the possible records for your various 
hardware systems, regardless of which operating system created the records. 


“Information about the MVS SCP” in Part 4 includes some suggested proce- 
dures for running EREP in a multisystem environment. 


In MVS systems, you can concatenate multiple data sets on the ACCIN DD 


statement, combining the records from several history data sets as input to 
EREP. 


Note that merging history and ERDS input from different systems is not a simple 
task; see Chapter 24, “System Control Programs (SCPs)” in Part 4. 
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Figure 1-4 summarizes the possible kinds of input to EREP and output from 
EREP. 
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Figure 1-4. Summary of EREP’s Input-Process-Output 
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EREP Controls 


What Are EREP Controls? 


In setting up an EREP run, you are doing five things: 

1. Indicating which report, if any, you want EREP to produce 

2. Selecting the appropriate records for the report 

3. Controlling how EREP processes the records and the report output 
4. Describing your installation’s configuration to EREP 


5. Defining the input and output data sets and requesting the storage EREP 
needs from the operating system. 


You use EREP parameters to accomplish the first two of these tasks; the third 
and fourth require other parameters and the EREP control statements. The fifth 
task requires system controls, which are different for each operating system 
control program (SCP). 


Introducing EREP Parameters and Control Statements 


The EREP controls can be grouped according to the kinds of information they 
convey to the EREP program. 


e Some parameters tell EREP which report, if any, you want it to produce. 
These are the report parameters. 


e@ Some parameters tell EREP which records to use for the requested report. 
These are the selection parameters. 


@ Some parameters control the way EREP processes the records and the report 
output. These are processing parameters. 


e The EREP control statements convey to the program still other kinds of infor- 
mation — primarily about your hardware configuration. 


Figure 1-5 through Figure 1-8 describe all the EREP parameters and control 
statements. 


The actual syntax for each parameter and control statement, and more detailed 


usage notes, are in Part 3, “Reference Information” and Part 4, “Product- 
Dependent Information.” 
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REPORT 
PARAMETERS | WHAT THEY DO 
EVENT Produces an Event History report, a chronological pres- 
entation of one-line abstracts from the selected records. 
It has two parts. 


PRINT Produces a series of Detail Edit and/or Summary reports 
for the selected record types. The number of reports 
depends on the input and selection parameters. 


Note: PRINT is the default report parameter. The only 
way to run EREP without producing any report 
output is to code PRINT=WNO. 


SYSEXN Produces a System Exception report series, reports cov- 
ering processors, channels, DASD and tape subsystems. 

SYSUM Produces a System Summary, a condensed two-part 
report of all errors for the principal system elements - 
CPU, channels, storage, SCP, I/O Subsystem. 


THRESHOLD Produces a summary of a tape subsystem, including 
media statistics and permanent errors that exceed the 
limits set on the parameter itself. 


TRENDS Produces an expanded version of the System Summary, 
presenting error records logged by or for the various 
system elements during 30 days, at most. Like the 
System Summary, it has two parts. 


Figure 1-5. Report Parameters for EREP 


The parameters in Figure 1-5 are the ones you use to request reports from EREP. 
You execute the EREP program once for every report you want, specifying the 
report parameter and other parameters in the job controls you use to submit the 
EREP program. For example: 


//ERRUN EXEC PGM=IFCEREP1,PARM='EVENT ,DATE=(86302) ,ACC=N' 


This MVS JCL EXEC statement, if combined with the other required system con- 
trols, would produce an Event History report of all the error records logged on 
October 29, 1986. 


DATE is one of the EREP selection parameters; see Figure 1-6 on page 1-11 and 
Chapter 7, “EREP Parameters.” 


ACC is one of the EREP processing parameters shown in Figure 1-7 on 
page 1-12 In this example, it indicates that the records are not to be copied to 
another data set. 


Figure 7-1 on page 7-4 shows the selection parameters you can use for each of 
the EREP report parameters. 
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SELECTION 

PARAMETERS | WHAT THEY DO 

CPU (Processor serial and machine type numbers) Tells EREP to use only the 
records associated with this particular processor. ; 

CPUCUA (Processor serial number and device address) Tells EREP to use only the 
records associated with this device attached to this processor. 

CUA (Device address or number) Tells EREP to use only the records associated 
with this particular device address or device number. 

Tells EREP to use only the records created during this date range. 


(Device type) Tells EREP to use only the records associated with this partic- 
ular device type; or, conversely, not to use the records associated with this 
device type. 


DEVSER (Device serial number) Tells EREP to use only the 34XX tape records associ- 
ated with this tape device serial number. 

ERRORID (Error identifier) Tells EREP to use only the MVS software records con- 
taining this particular error identifier. 

LIA/LIBADR (Line interface [base] address) Tells EREP to use only the 3705 or 3725 com- 
munication controller records containing this line interface address. 
(Processor model) Tells EREP to use only the records containing this 
processor machine type (number). 

(370 or 370-XA) Tells EREP to use only the records created in this operating 

mode. 

SYMCDE (Fault symptom code) Tells EREP to use only the 33XX DASD records con- 
taining this particular fault symptom code. 

TERMN (Terminal name) Tells EREP to use only the VTAM or TCAM OBR records 
containing this terminal name 


TIME Tells EREP to use only the records created during this time range. 
(Record type) Tells EREP to use only the records of the specified type(s). 


VOLID (Volume serial number) Tells EREP to use only the 33XX DASD or 34XX 
tape records containing this volume serial number. 


Figure 1-6. Selection Parameters for EREP 




















EREP Selection Parameters 


The parameters in Figure 1-6 are the ones you use to select the records EREP is 
to use in a requested report. Some of the parameters are mutually exclusive, as 
shown in Figure 12-1 on page 12-2. The correct syntax and other details about 
these parameters are in Chapter 7, “EREP Parameters.” 
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PROCESSING 

PARAMETERS | WHAT THEY DO 

ACC (Accumulate) Tells EREP to copy the records used for 
the report onto an output history data set. 

HIST (History) Tells EREP that its input consists of records on 
a history data set. 

LINECT (Line count) Tells EREP that each page of the report 
output is to contain this number of lines. 

MERGE (Merge) Tells EREP that its input consists of records 
from both the ERDS and a history data set. | 

SHORT (Short OBR) Tells EREP to print out short-form OBR 
records in Detail Edit report output. 

TABSIZE (Table size) Tells EREP that the sort table it uses for 
internal processing is to be this big. 


ZERO (Zero ERDS) When this report is complete, EREP is to 
clear the error-recording data set (SYSREC, or 
SYS1.LOGREC, or the error recording area). 


Figure 1-7. Processing Parameters for EREP 














EREP Processing Parameters 
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The parameters in Figure 1-7 are the ones you use to control the way EREP 
processes the records you have selected. Their functions differ widely; they are 
described in the individual topics in Chapter 7, ““EREP Parameters.” 


J 
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EREP Controls 


CONTROL 
STATEMENTS WHAT THEY DO 
CONTROLLER Tells EREP to combine the error records associated 
with this particular control unit and its attached 
devices. 


DASDID Tells EREP that this is the configuration of the 33XX 
DASDs within each subsystem; identifies those that do 
not provide physical IDs for the System Exception 
report series. This control statement applies only to the 
System Exception Report series. 


ENDPARM Tells EREP that this is the end of the instream EREP 
parameters; the instream data that follows consists of 
EREP control statements. 


LIMIT 





























Tells EREP not to produce any output for the System 
Exception reports when the number of errors is below 
the values specified here. This control statement 

applies only to the System Exception Report series. 







Tells EREP to combine the records for these devices 
that are shared between systems. This control state- 
ment applies to all the reports that generate I/O device 
summaries. 


Figure 1-8. Control Statements for EREP 


EREP Control Statements 


The statements shown in Figure 1-8 are control statements for the EREP 
program. They give EREP more permanent information about your configura- 
tion, and set overall criteria for the way EREP is to create a report. They are 
described in detail in Chapter 8, “EREP Control Statements.” 


Chapter 1. Introduction to EREP 1-13 


System Controls 


Introducing System Controls 


When you run EREP, you must ask the operating system to allocate storage and 
space on devices to hold EREP’s input and output data and work spaces. You 
must also define the data sets and space required by the operating system for its 
own purposes. And you must present EREP to the operating system as a job to 
be executed. System controls do these things for you. 


Each of the three operating systems uses different system controls for EREP: each 
has different names for the data sets it requires, and each has a different way for 
you to execute a job. See the sections headed “System Controls” in 

Part 2, “Setting Up and Running EREP” for detailed information about the dif- 
ferent system job controls. What follows here is a general explanation of the dif- 
ferences in the way EREP works with the VSE, MVS, and VM systems. 


When you run EREP to request a report, you have to submit a job to the oper- 
ating system you want EREP to run under. If it is a VSE or MVS system, you 
supply JCS or JCL statements defining the necessary data sets, units and/or 
logical units and directing the system to execute the program named IFCEREPI. 
Having created the job or series of job steps, you submit it to the system as a 
batch job or interactively via TSO. 


If you want to run EREP under VM, you enter the CPEREP command from the 
CMS environment. You have the option of being prompted for each of the 
CPEREP operands (EREP parameters and control statements) you want to apply 
to this execution of EREP, or of stacking the operands for the system to read, or 
putting the operands into a file named on the CPEREP command. 


How EREP Runs Under an Operating System 
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Once EREP is executing, it works the same way regardless of the operating 
system it is running under: 


e It obtains virtual storage from the system, in which it builds various tables 
needed to sort the records for the report. 


e It then reads each record from the input data set(s), selecting for the report 
those that meet the criteria set up by record selection parameters. 


e It sorts the selected records according to the way the report is to present 
them, and builds a line of the report in the EREPPT (or SYSLST) data set. 


@ When all the selected records are processed and the report is complete, it 
prints the EREPPT and TOURIST data sets. 


e Finally, it frees the virtual storage it used for its sort tables, and returns 
control to the system. 


The storage requirements for EREP vary widely, depending on the kind of report 
you request. You can adjust the amount of storage available for EREP, within 
system limits. The process is described in the sections headed “Storage Require- 
ments” in Part 2, “Setting Up and Running EREP.” 


J 
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Defining Data Sets for EREP 


Before you execute the EREP program, you must define two unique data sets for 
it to use: 


1. The TOURIST data set (in VSE, the SYSLST logical unit), to which EREP 
writes messages and other processing information 


2. The EREPPT data set (again, the SYSLST logical unit), in which EREP 
builds the report you are requesting. 


In addition to these two, you must also define the other input and output data 
sets, depending on where the input records are and whether or not you want them 
copied to an output data set after processing. 


Figure 1-9 shows all the system controls required for EREP by each operating 
system. See the sections headed “System Controls” in Part 2, “Setting Up and 
Running EREP” for more detailed descriptions. 


























INPUT AND OUTPUT 
FOR EREP 


VSE JOB 
CONTROLS (JCS) 


MVS JOB 
CONTROLS (JCL) 


The ERDS SYSREC! SERLOG DD statement; SERLOG? FILEDEF 
DSN =SYS1.LOGREC 
History Input T/DLBL HISTINT/D; CS eee | DD statement eee FILEDEF 
ASSGN SYS008 


Work Data Set for History DLBL IJSYS01, EXTENT bicsticiasac DD statement faces FILEDEF 
Input SYS001 .. . ; ASSGN 
SYS001 
History Output T/DLBL HISTOT/D; ACCDEV DD statement ACCDEV? F ILEDEF 
ASSGN SYS009 


EREP Messages SYSLST! TOURIST DD statement TOURIST? FILEDEF 
EREP Reports SYSLST! EREPPT DD statement EREPPT? FILEDEF 


EREP Controls SYSIPT! SYSIN DD statement (or CPEREP operands 
EXEC statement) 


Figure 1-9. System Controls for EREP, by System Control Program 


VM 
CONTROLS 





Notes: 


1. These logical units should already have been assigned at system|partition initial- 
ization. 


2. CPEREP issues the FILEDEF commands for these files; you may override some 
of them. 
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Chapter 2. EREP Reports 


The EREP reports are designed to give you a variety of views of the data being 
processed. EREP produces: 


@ Overview reports, from which you can determine if there are problems 
e Analysis reports, from which you can determine where there are problems 
@ Detail reports, from which you can determine what the problems are. 


In order to monitor your installation — and, thus, catch problems early — you 
need to see certain EREP reports regularly. The sample EREP runs in 
Part 2, “Setting Up and Running EREP” are set up to accomplish this. 


In order to decide which report to run at which time, you need to understand 
what each one is telling you. The following text describes the different kinds of 
EREP reports individually, to give you an idea of what they show and help you 
decide which reports to include in your EREP runs. It presents the reports in the 
order of most general to most specific. 


IMPORTANT NOTE 


The exact format of the reports depends upon the hardware devices installed and the 
version of EREP which you are running. However, the general examples should 
help as you plan your EREP run. For more detailed information about the various 
parts of the reports, see the maintenance documentation for the product involved. 
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System Summary 


System Summary Part 1 


System Summary Part 2 
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The System Summary report, produced when you code the SYSUM report 
parameter, is an overview of errors for each of your installation’s principal parts, 
or subsystems: processors, channels, subchannels, storage, operating system 
control programs (SCPs), and I/O subsystems. 


The report has two parts, the first part summarizing errors from all but the I/O 
subsystem, and the second summarizing errors recorded in the I/O subsystem. 


Useful parameters for customizing your System Summary report are: 


DATE 
MODE 
TIME 


Care should be taken when specifying report parameters other than these as 
report results could be misleading. See Figure 12-1 on page 12-2 in Part 3 for 
any restrictions on using the parameters in combination. 


The first part of the System Summary report varies according to the mode of the 
records it summarizes. For records logged when a processor is running in 370 
mode, you see counts of machine checks (MCH records) and channel checks 
(CCH records) by channel; for records recorded in 370-XA mode, in addition to 
the machine-check totals, you see counts of subchannel logouts (SLH records) by 
channel path ID, and channel report words (CRW records) created by both hard- 
ware and software. 


The rest of the first part of the System Summary shows counts of software events 
that may or may not be associated with errors: IPLs and system termination. For 
MVS only, it also includes actual software error records. 


The record counts are listed by processor (CPU); each processor is identified by a 
letter. See “How EREP Assigns Letters to CPUs” on page 2-92 for an explana- 
tion of the way these letter identifiers are assigned. The System Summary can 
only report on 10 processors; if your installation has more than 10, EREP 
produces the report using records from the first 9 processors it encounters. It also 
issues a message (IFC134I; see Chapter 11) explaining what is going on. 


The second part of the System Summary is a condensed report of every perma- 
nent and temporary error recorded for the I/O devices in your installation, listed 
under the processor associated with the error. If your processors share I/O 
devices, you must use SHARE control statements for the System Summary if you 
want to see I/O errors combined for all the possible paths to a device that is 
common to different systems. See “SHARE Control Statement.” 


System Summary 


Permanent and Temporary I/O Errors: In the System Summary, as well as in 
several other reports, EREP divides I/O errors into permanent errors and tempo- 
rary errors. A temporary error is a read or write operation that failed, was retried, 
and eventually succeeded. A permanent error is a read or write operation that 
failed and was retried several times without success. See “Tape Subsystem Excep- 
tion Report” on page 2-47 for more information about permanent errors. 


The temporary errors that appear in Part 2 of the System Summary are totals of 
temporary read/write errors and statistical data. 


Part 2 of the System Summary puts the temporary and permanent I/O errors in 
product or device groups. Following is a list of the product groups in the order 


they appear in Part 2 of the System Summary. 


1. Console and unit record devices: 


a. Operator’s console 
b. Card reader 
c. Card punch 
d. Printer 
e. OCR/MICR 
2. Dhirect-access storage devices: 
a. Disk 


b. Drum/fixed-head file 
c. Mass storage system 
Tape devices 
Displays (channel-attached) 
Teleprocessing (TP) communications controllers 
Terminals 
Other devices: 
a. Channel-to-channel adapter 
b. Cryptographic unit 
c. Dynamic pathing availability (DPA) 
8. Unknown devices: 
a. Unrecognized device types 


IAM YW 


The System Summary presents the errors by control unit or device address for 
each device type. The device address can be the CUA, for 370-mode records, or 
the device number, for 370-XA-mode records. If the report includes both 370- 
and 370-XA-mode records, the errors are combined. If your installation includes 
products that have physical IDs, the errors are listed according to the entire phys- 
ical ID. See “DASDID Control Statement” for the explanation of DASD phys- 
ical identifiers. 


EREP summarizes the I/O error data by the control unit/device address or 
number of the device reporting each error. 
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Figure 2-1, Parts 1 and 2, is an example of the System Summary, Parts | and 2. 
Following are the MVS JCL statements that produced the report. 


//SYSUM EXEC PGM=IFCEREP1,PARM=(SYSUM, 
"MODE=ALL' , 'ACC=N' , HIST) 

//TOURIST DD  SYSOUT=R 

/ /EREPPT DD SYSOUT=R 

//DIRECTWK DD UNIT=SYSDA,SPACE=(CYL,5, ,CONTIG) 

/ /ACCIN DD DSN=EREP.WEEK1.HISTORY , DISP=OLD 

//SYSIN DD DSN=D58ELM.SHARE.STMTS , DISP=OLD 

[SHARE statements for appropriate I/O devices] 


/* 


Specific fields and abbreviated headings are explained in the numbered notes fol- 
lowing each part of the figure. For more detailed information about hardware pro- 
ducts included in the report, see the maintenance documentation for the product 
involved. 


J 


System Summary 





SYSTEM SUMMARY REPORT DATE 025 84 
(PART 1) PERIOD FROM 329 83 
CPU/CHANNEL/STORAGE/SCP TO 334 83 


TOTAL CPU-A 


IPL 0 0 


MACHINE CHECK 


RECOVERABLE 0 0 
NON- RECOVERABLE 


(o) 
oO 


CHANNEL CHECK 


CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 
CHANNEL 


ymonwrwuouOwsnuwnwAwWwnNnNEe Oo 
qooooo0oajeoooo0o0o0o0o0$9njpe{0e°o 
oooooo0ocooooocojoco7c”jo 


PROGRAM ERROR 
PRGM INTF 0 0 
ABEND 13 13 
RESTART 0 0 
END OF DAY 0 0 


TOTAL RECORDS 13 13 


CPU MODEL SERIAL NO. 
A 3081 220864 


Figure 2-1 (Part 1 of 2). System Summary 
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System Summary 





SYSTEM SUMMARY REPORT DATE 025 84 
(PART 2) PERIOD FROM 329 83 
I/O SUBSYSTEM TO 334 83 

TOTAL CPU-A 


PERM TEMP PERM TEMP 
DASD STRINGS ¥eRREKKEKKKKKKKERKEKKKKKK 


3350 25x 0 2 0 2 
3350 26X 0 22 0 22 
3350 35x ) 2 0 2 
3350 36x 0 40 0 40 
3350 SAX ) 1 0 1 
3350 71x 0 1 0 1 
3350 76X 0 43 0 43 
3350 77x 0 1 0 1 
B6-XX-XX 0 2 = . 
) 65 - a 
3400 4Dx 0 24 0 24 
3400 F7X 0 81 0 81 
3400 FEX 0 4 0 4 
TP CNTRL REKKEKKEKEKKKKKKEKKEKKKKEEKE 
3705 015 
LINES 8 1324 8 1324 
3705 o1c 
LINES 1 37 1 37 
3705 OBE 
LINES O 155 O 155 
3705 603 
LINES 4 155 4 155 
TOTALS 13 1959 13 1957 


CPU MODEL SERIAL NO. 
A 3081 220864 
Figure 2-1 (Part 2 of 2). System Summary 
Notes: 
I. CHANNEL CHECK /f there are 32 channels, then the channel check summary 


will display channels X’10’ through X’1F only if there is any activity on those 
channels. 
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Trends Report 


Trends Report 


The Trends report, which you request using the TRENDS report parameter, is 
similar to the System Summary. The main difference between the two is that, in 
the Trends report, the error data is presented by the Julian day, in chronological 
order. Part | presents IPL, MCH, CCH/SLH/CRW, and Program Error (soft- 
ware) records for each processor. Part 2 shows permanent and temporary I/O 
errors for the same product/device groupings listed on page 2-3. Within product 
groups, the errors are presented by device address or number or physical ID 
within generic device or product types. The processor (CPU) associated with the 
record! appears on the line with the device address/number. 


As in the System Summary, you must provide SHARE control statements if you 
want EREP to combine all the errors reported by a single I/O device that is 
common to different systems. Without SHARE statements, the Trends report 
shows separate entries for the device — one for each processor it is connected to. 
See “SHARE Control Statement” for details. 


Useful parameters for customizing your Trends report are: 


CUA 
DATE 
DEV 
MODE 
TIME 
TYPE 


Care should be taken when specifying report parameters other than these as 
report results could be misleading. See Figure 12-1 on page 12-2 in Part 3 for 
any restrictions on using the parameters in combination. 


In addition, see “DEV” on page 7-11 for some restrictions on the record types 
you can select. 


For the Trends report, you can use the DATE parameter to see records other 


than those created in the last 30 days, the default. However, you may not select 
more than 30 consecutive days of records. 


l Except in the case of devices providing physical IDs; they are associated not with a 
CPU, but with the control unit. 
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Figure 2-2, Parts 1 and 2, is an example of the Trends report, Parts | and 2. 
Following is the MVS JCL that produced the report. 


//TRENDS EXEC PGM=IFCEREP1,PARM='CARD' 

//TOURIST DD  SYSOUT=R 

//EREPPT DD  SYSOUT=R 

//DIRECTWK DD UNIT=SYSDA,SPACE=(CYL,5,,CONTIG) 

/ /ACCIN DD DSN=D24RBH1.XAFULL.HISTORY ,DISP=OLD 
DD DSN=R24RBH1.SP211FT.FULL.HISTORY , DISP=OLD 
//SYSIN DD * 

TRENDS 

HIST 

ACC=N 

TABSIZE=200K 

DATE= (82085-82114) 
CPU=(020022.3081,220022.3081,020015.3081,220015. 3081) 
ENDPARM 

[SHARE statements for appropriate I/O devices] 


J* 


Specific fields and abbreviated headings are explained in the numbered notes fol- 
lowing each part of the figure. For more detailed information about hardware pro- 
ducts included in the report, see the maintenance documentation for the product 
involved. 


J 


Trends Report 





TRENDS REPORT REPORT DATE 014 84 
CPART 1) PERIOD FROM 088 82 
CPU/CHANNEL/STORAGE/SCP TO 114 82 
JULIAN 82 
ge 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 
IPL 
cpu A 0 6 @ 2121 2 212 1 2 0 60 3 2 6 2 @© © © 2 2 313 3 2 2 606 2 3 8 0 6 1 
cPeu B oo 06 960 60 0 0 0 060 909 0 0 0 0 0 6 6 0 80 6 0 0 0 0 0 60 08 0 6 9 
cpu ¢ 0 6 6 2 2 46 1 1 1 @© 2 60 2 1 60 6 8 12 2 3 12 2 0 23 2 12 Y F&F 2 1 
cPU D oo 0 06 600600 000 0 060 0 0° 0 0° 6 0 0 6 0 060 0 0 6 0 0 6 6 08 0 
MACHINE CHECK 
cpu A 0 606 060 060 0 60 060 6 606 0 0 0 60 0 0 60 00 @ 0 12 @ 09 09 0© 0 9 0 0 9 
cpu B 0 06.6 60 060 0060 600 0 060 60 0 0 0 60 0 0 6 60 0 0 606 06 0 0 0 @ 90 
cPu c oo 6 060 0 606 060 40 6 0 6 0 60 #1 6 6 6 6 6 0 1 0 909 0 0 0 6 90 6 9 
cPU D 0 6.6.6 060 060 6 60060 0 60 0 0 0 0 060 6 06 60 60 0 9% 9 0 6 6 60 0 o 90 
CHANNEL CHECK 
cpu A 0 0 6 060 0 8 0 0 00 060 0 6006 0 0 60 0 6060600 0 6 0 6 0 08 90 
eecPeu 8B oF 6 6 © @© 0 © 6© 0 860 6© 0 6 60 © 0 6 0 © 09 0 0 0 © 0© 0 0 0 0 2 
cpu ¢ 0 6 060 060 6 0606 0 6 060 0 6 060 6 60 60 60 60 60 060 0 0 60 60 6 6 90 080 0 9 
cPu D Oo 0 6 6 0 60 0 0 60 0 0 6 0 6 606 6060 0 0 0 060 0 0 0 0 060 6 6 6 6 
PROGRAM ERROR 
cpu A 0 09 O 0 o © 0 0 © 60 6 060 6 6 60 0 0 0 60 6 0 0 @ 0 © o 0 
cPu B 0 6 OO 99 298 123 120 62 oO 6 77 10 51748 oOo 60 0 6 286 79 56 16 6 1 85 108 119 70 51 10 
cPu Cc 0 0 0 0 6 60 060 060 0 0 40 0 0 @© 0 6 060 60 606 060 600 06 0 0 0 6 0 0 
cPU D oO 0. 0 161 192 155 999 51 0 O 73 12 44103 O OO OO 13 371 S51 29 12 9 3 92 #98 151 67 38 9 
CPU MODEL SERIAL NO. 
A 3081XA 220015 4 | 
B 3081 220015 
c 3081XA 020015 
D 3081 020015 
TRENDS REPORT REPORT DATE 014 84 
(PART 1 CONTINUED) PERIOD FROM 088 82 
SUBCHANNEL/ CHANNEL TO 114 82 


JULIAN 82 
DAY 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 
SUBCHANNEL 
cPU A 
NO ERRORS FOR THIS CPU 
cPpU B 
NO ERRORS FOR THIS CPU 
cpu oc 
CHPID 00 
CHPID 05 
CHPID 10 
CHPID 11 
CHPID 16 
CHPID 21 
CHPID 24 
cpu oD 
CHPID 15 0 0 0 26 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 


CHANNEL REPORT WORD 
CPU A 


egoooooo 
ooooo°oo 
egoooooo 
qgoqoooo°o0o 
eaaooono 
eaQacoore 
qgooooceEe 
aoooo00oo 
egoooooco 
eaeoooooo 
ecooo0oosto 
eoeoooo 
eoooonao 
eaooo0otoa 
aooooo0o 
ecoaocoeoce 
eocooooo 
KO OOONCO 
qgooooro 
3r-acdowoe 
~wwMonow 
eoocoor& 
sr 20000° 
qgoooeoo0oe 
eoo0o00o0rf?e 
eoecaqaona 
eooo0oeceo 
eoooooo 
ooooo0o0 
eooooe fo 


HARDWARE 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 

SOFTWARE 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
cPU 8B 

HARDWARE 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 

SOFTWARE 0 6 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
cPU C 

HARDWARE 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 

SOFTWARE 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
cPU D 

HARDWARE 0 6 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 \] 

SOFTWARE 0 0 0 0 0 6 0 Q 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 


CPU) MODEL SERIAL NO. 


3081XA 220015 

Sos 220015 (EY 
020015 

3081020015 


9v0ON» 
uw 
Qo 
oo 
-_ 
ba 
> 


Figure 2-2 (Part 1 of 2). Trends Report 
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Trends Report 


2-2 (Part 2 of 2). 


Figure 


Notes: 


System error types, by processor (CPU). 


i. 


2. Each column contains error counts for one day; unless you specify a shorter date 


range, the report covers 30 days. 


3. For CCH (and SLH) records, only those channels (channel paths) with errors 


appear in the report. 


2 


4. Processors, identified from filtered data and/or share statements. XA indicates 


that the processor was running in 370-XA mode. 
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Trends Report 


This section of the report appears only if 370-XA mode records are present. 
Device group. 


Each column represents one day. A field of all 9s indicates that this number 
was larger than the print positions allowed. 


Device type. 


CPU-CUA (or device number) path. 
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Event History Report 
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The Event History report consists of one-line abstracts of selected information 
from each record, listed in chronological order. You request the Event History 
using the EVENT report parameter. Its primary value lies in showing you errors 
and events in context, letting you see the frequency, order, and pattern of their 
occurrence. 


Because it is so highly condensed, however, the Event History can be difficult to 
read. To make things easier, the first part of the report output is a template 
showing the headings used for the record-dependent data from each type of 
record. The second part of the output is the Event History itself. The third part 
is a summary, by processor (CPU) identifier, of all the records presented in the 
report, with totals for each record type. See “How EREP Assigns Letters to 
CPUs” on page 2-92 for the explanation of the letter identifiers. 


Useful parameters for customizing your Event History report are: 


CPU 
CUA 
DATE 
DEV 
MODE 
TERMN 
TIME 
TYPE 
VOLID 


Care should be taken when specifying report parameters other than these as 
report results could be misleading. See Figure 12-1 on page 12-2 in Part 3 for 
any restrictions on using the parameters in combination. 


Note: Control statements (CONTROLLER and SHARE) are not appropriate for 
the Event History, because it is a chronological presentation of errors. 


Figure 2-3 and Figure 2-4 show the heading templates for 370 and 370-XA mode 
records, respectively. Figure 2-5 is an example of the Event History report. 
Figure 2-6 is an example of the Event History summary. Following are the MVS 
JCL statements that produced the report. 


//EVENT EXEC PGM=IFCEREP1,PARM=(EVENT, 'DATE=(82124)', 
// 'MODE=ALL', 'ACC=N' , HIST) 

//TOURIST DD SYSOUT=R 

/ /EREPPT DD SYSOUT=R 

//DIRECTWK DD UNIT=SYSDA,SPACE=(CYL,5,,CONTIG) 


//ACCIN DD DSN=EREP.WEEK1.HISTORY,DISP=OLD 
//SYSIN DD DUMMY 
Dd 


Note the absence of SHARE statements; the Event History does not use them. 


Specific fields and abbreviated headings are explained in the numbered notes fol- 
lowing the figures. For more detailed information about the various parts of the 
reports, see the maintenance documentation for the product involved. 


Event History Report 


EVENT HISTORY TEMPLATE (S/370) 


FOR RECORD TYPES: RECORD DEPENDENT DATA 


MCH: PSW-MCH /PROG-EC ERROR-ID 

CCH: CUA DEVT CSW 

OBR: CUA DEVT CMD CSW 

MDR : CUA DEVT VOLUME/TERM NAME 
MIH: CUA DEVT CSID VOLUME/TERM NAME 
DDR: CUA DEVT VOLUME/TERM NAME 
OBR-DMT, OBR-EOD: CUA DEVT VOLUME/TERM NAME 


OBR-PRM, OBR-TMP: CUA DEVT CMD CSW SENSE 04 06 O08 10 12 14 16 18 20 22 VOLUME SEEK SD CT 


OBR-DPA: CUA DEVT SCUA SNID 

SFT: REASON PSW-MCH /PROG-EC RCYRYXIT COMP/MOD CSECTID ERROR-ID 

IPL: SSYS ID REASON 

MDR-DAS : CUA DEVT SENSE 04 06 O08 10 12 14 #16 18 20 22 VOLUME SEEK SD CT 


EOD: * ONLY COMMON PREFIX DATA FOR THIS RECORD TYPE. 


COMMON PREFIX: (FOR ALL RECORD TYPES) 
TIME JOBNAME RECTYP CP 


Figure 2-3. Event History Template for 370 Mode Records 


Note: See the list of abbreviations following the Glossary for explanations of the abbreviations used in the 
template. 
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EVENT HISTORY TEMPLATE (S/370XA) J 
FOR RECORD TYPES: RECORD DEPENDENT DATA 
MCH : PSW-MCH /PROG-EC ERROR-ID 
SLH: DNO DEVT CHP SCSW ESW 
CRW: DNO CRW 
OBR: DNO DEVT CMD SCSW 
MDR: DNO DEVT CHP VOLUME/TERM NAME 
MIH: DNO DEVT CHP REASON CSID VOLUME/TERM NAME 
DDR: DNO DEVT VOLUME/TERM NAME 
OBR-DMT, OBR-EOD: DNO DEVT CHP VOLUME/TERM NAME 


OBR-PRM, OBR-TMP: DNO DEVT CHP CMD SCSW SENSE 04 06 08 10 12 «14 16 18 20 22 VOLUME SEEK SD CT 


OBR~-DPA: DNO DEVT CHP CMD SCSW SPID SNID 
SFT: REASON PSW-MCH /PROG-EC RCYRYXIT COMP/MOD CSECTID ERROR-ID 
IPL: SSYS ID REASON 
MDR-DAS: DNO DEVT CHP SENSE 04 06 08 10 12 14 16 18 20 22 VOLUME SEEK SD CT 
EOD: * ONLY COMMON PREFIX DATA FOR THIS RECORD TYPE. » 
COMMON PREFIX: (FOR ALL RECORD TYPES) 
TIME JOBNAME RECTYP CP 


AN ASTERISK(*) PRECEDING THE CPU LETTER INDICATES A S/370XA MODE RECORD 


Figure 2-4. Event History Template for 370-XA Mode Records 


Note: See the list of abbreviations following the Glossary for explanations of the abbreviations used in the 
template. 
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Event History Report 





EVENT HISTORY (57370 & S/7370XA) REPORT DATE 124 82 
PERIOD FROM 124 82 
PERIOD TO 124 82 


SPID SNID 
BYTES DATA CK SEEKS OVERRUN 
RD/SRCHD COR/RTRY CNT/“ERR COM/DATA 
SSYS ID REASON PSW-MCH /PROG-EC RCYRYXIT COMP/MOD CSECTID ERROR-ID 
TIPE JOBNAME RECTYP CP CUA DEVT CMD CSW SENSE 04 #06 08 10 12 14 #16 18 ###+%20 22 #£VOLUME SEEK $D CT 
x DNO CRW CHP SCSW ESW 

DATE 124 82 
07 10 10 16 MSTRUCL SFIPI 8B 800C4000 070C000000099AD8 IEAVTMMT IEAVTMMT IEAVTMMT 0030000000010003F033 
07 13 25 41 MSTRICL SFIPI B B00C4000 O70COCCO00O99ADS IEAVTMMT IEAVIMMT IEAVTMMT 0032000000010003F7D3 
07 29 28 06 OBRIMP C OE2 3277 RPO7LO 
07 34 28 48 D24RAC1 SFTABN A 00136000 070C000000C70846 ICVCMEO02 IGC00131 ICVDSDO3 00330000001E00042929 
07 36.11 25 MSTRJCL SFIPI. B 800C4000 O70CD00000099AD8 TEAVIMMT  YEAVTMMT IEAVTMMT 00350000000100042D2D 
07 36 14 69 MSTRJCL SFTPI A 800C4000 070C000000099AD8 IEAVTMMT IEAVIMMT TIEAVTIMMT 00370000000100042D50 
07 44 23 28 OBRTMP D O0E5 3277 RPO7LO 
07 44 23 28 OBRIMP D OE8 3277 RPO7LO 
07 44 23 29 OBRIMP D OE6 3277 RPO7LO 
07 46 23 29 OBRTMP D OE? 3277 RPO7LO 
07 44 23 30 OBRIMP D OEO 3277 RPO7LO 
07 44 23 30 OBRTMP D 0E9 3277 RPO7LO 
07 44 23 31 OBRTMP D OEA 3277 RPO7LO 
07 44 23 32 OBRTMP D OEC 3277 RPO7LO 
07 44 23 32 OBRTMP > OEB 3277 RPO7LO 
07 44 23 34 OBRTMP D OED 3277 RPO7LO 
07 44 23 45 OBRIMP Cc 0E4 3277 RPO7LO 
07 45 04 56 OBRTMP C OE3 3277 RPO7LO 
07 46 47 13 OBRTMP D OFE 3705 OFE-$ 
0747 2371 NVA MDR D OFE 3705 
07 47 23 87 NA MDR D OFE 3705 
07 48 24 74 OBR D 6B6 3277 03 8200 RPO7L6 
07 51 46 17 OBRTMP C 60F 3800 
07 53 37 50 D&3WwsM1 MIH MA 705 3330 START PENDING D92722 
07 53 51 94 DISMBP1 OBRIMP C 9CA 3330 0% 0200 10000000 2A420630 2EB00000 00040000 00000000 00000000 D92494 = 66 6 
07 54 08 98 NMASTER™ MIH mB 7C5 3330 START PENDING D92722 
07 54 40 $6 NMASTERM MIH *B 7C5 3330 START PENDING D92722 
07 54 56 69 DS3PAH1 OBRTMP C 9CF 3330 04 0200 10000000 07640030 2EB00000 00040000 00000000 00000000 1P0004 100 0 
07 55 11 93 MMASTER™ MIH “MB 7C5 3330 START PENDING D92722 
07 55 27 00 D60JDN1 OBRTMP C 9C4 3330 04 0200 10000000 1€640030 2E300000 00040000 00000000 00000000 IPOLO1 100 0 
07 55 43 41 MMASTERM MIH mB 7C5 3330 START PENDING D92722 
07 56 14 89 NMASTERN MIH *B 7C5 3330 START PENDING D92722 
07 56 14 97 D71DJB1 OBRTMP HB 7C4 3330 12 31 0C00 OOF72F48 06000005 10000000 10640030 2E300000 00040000 IPOLO! 0 0 
07 56 46 37 MMASTERM MIH “xB 705 3330 START PENDING D92722 
07 56 46 43 FRANKXAL OBRTMP MB 7CC 3330 12 04 0CO0 OOF31338 06000006 10000000 1€350930 2EB00000 00040000 D24PAK 0 0 
07 57 17 85 MMASTER® MIH MB 7C5 3330 START PENDING D92722 
07 57 17 87 FRANKXAL OBRTMP MB 7CC 3330 12 04 0COO OOF6FB38 06000006 10000000 1CSAOF30 2EB00000 00040000 D24PAK 0 0 
07 57 49 32 MMASTERM MIH MA 7C5 3330 START PENDING p92722 
07 57 49 34 SMITHXAL OBRTMP HB 7CC 3330 12 04 0C00 OOFS69BB 06000006 10000000 10360330 2EB00000 00040000 D24PAK 0 0 
07 57 59 22 DISKTK1 OBRIMP WB 4AD 3330 04 29 0CO0 00F72560 DE00002C 10000000 550D001F 08000000 00000002 POK150 0 0 00 
07 58 03 95 D24JAL1 OBRTMP C 9CO 3330 04 0200 10000000 38000130 2E300000 00040000 00000000 o0000000 CLRI2A 0 1 
07 58 20 80 MMASTERM MIH MA 705 3330 START PENDING D92722 
07 58 30 47 NONE-FRR SFTABN A oogABooD O70C100000B66B40 IKTIOFRR  IKTIOMOZ IKTOMLUO 00390042601B0004617E 
07 58.52 28 ™MASTERM MIH mB 705 3330 START PENDING D92722 
07 58 52 33 DISDES1 OBRITMP MB 7CA 3330 12 31 0COO 0OF72D48 06000005 10000000 24420630 2E300000 00040000 092494 0 0 
07 59 23 76 HMASTERM MIH MB 7C5 3330 START PENDIN D92722 
07 59 55 23 MMASTERM MIH MA 705 3330 START PENDING D92722 
07 59 55 27 DAVEXA] OBRTMP HB 7CC 3330 12 31 0COOD 0OF7 1448 06000005 10000000 106330030 2E300000 00040000 D24PAK 0 0 
08 00 10 97 DISDFY1 MIH HA 7CA 3330 START PENDIN D92873 
08 00 2© 39 DISMBP1Z OBRTMP C 9C2 3330 31 0200 10000000 20020030 2E300000 00040000 00000000 00000000 092689 2 0 
08 00 26 71 *MASTER* MIH NA 705 3330 START PENDING D92722 
08 00 41 16 DISMBP1Z OBRTMP C 9CA 3330 04 0200 10000000 2A001230 2EB00000 00040000 00000000 00000000 092494 0 18 
08 00 42 45 MMASTERM MIH MB 7CA 3330 START PENDING D92873 
08 09 58 19 MMASTERM MIH mA 7C5 3330 START PENDING D92722 
08 01 31 23 OBR C BBD 3277 03 8200 RPO7LB 
08 02 32 77 MSTRIJCL SFTPI 8B 800C4000 070C000000099AD8 IEAVTIMMT IEAVTMMT IEAVIMMT 00450000000100046AF5 
08 04 10 86 MSTRICL SFIPI 8B 80004000 070C000000099AD8 IEAVIMMT YEAVIMMT IEAVTMMT 004A0000000100046ECA 
08 05 34 24 MSTRICL SFIPI 8B 80004000 070C000000099AD8 IEAVTMMT IEAVTMMT IEAVTMMT 00400000000100047208B 
08 05 40 95 PSTRJCL SFTPI A 800C4000 070C000000099AD8 IEAVIMMT JEAVTMMT IEAVTMMT 004F000000010004724E 
08 05 44 34 DIOSCB1 $LH mB 208 3330 02 0502441700FESEBS00020006 00807484 
08 07 04 90 OBR C BEI 3277 03 8200 RPO7LB 
08 07 20 79 NONE-FRR SFTABN A OOOABO00 070C100000866%68 IKTIOFRR IKTIOMO2 IKTIMLUO 00500062004500047635 
08 13 51 73 MSTRICL SFTPI A 80004000 070C000000099AD8 IEAVIMMT IEAVTMMT YEAVTMMT 0055000000010004857A 
08 13 54 26 MSTRICL SFIPI A 800C4000 O70C000000099AD8 IEAVINMT IEAVTMMT YEAVTMNT 00570000000100068594 
08 16 15 12 MSTRJCL SFIPI A 80004000 O70CO000D0099ADS IEAVIMIIT YEAVTMMT JEAVIMMT 005A0000000100048664 
08 15 29 85 MSTRJCL SFTPI A 80004000 070C000000099AD8 IEAVIMNMT IEAVTMMT IEAVIMMT 005€0000000100048950 
08 15 33 72 DSSHBMi SFTABN A OO1SE000 070C000000C70846 ICVCMEO2  IGCOOLSI ICVDSDOS 005D0000005400048976 
08 15 41 37 MSTRJCL SFTPI 8B 80004000 070C000000099AD8 IEAVTIMMT IEAVTMMT YJEAVIMMT 005F00000001000689C3 


Figure 2-5. Event History Report 
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Event History Report 


Notes: ) 


I. The header is a universal type. Headers for each record type are provided on 
the templates illustrated in Figure 2-3 and Figure 2-4. 


2. CPU models and serial numbers associated with the letter identifiers are shown 
at the end of the report summary. The letter identifiers are internal to the 
Event History (high-order serial number assigned letter A) and should not be 
confused with external CPU machine identifiers. 


3. Under SEEK is the DASD cylinder head or block number, under SD CT is the 
storage director/controller physical ID for DASD. 


4. An asterisk (*) preceding the processor (CP) letter indicates a 370-XA mode 
record. 


Special Note: For any products that record OBR records asynchronously, only the 
sense data reflect the origin of an error record. The other informa- 
tion in the record might reflect the recording device rather than the 
device that has the problems. 
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Event History Report 





RECORD TYPES TOTAL CPU-A CPU-B CPU-C CPU-D 
MCH 0) 0 0) 0 0 
MCHTRM 0) 0 0 0) 0) 

MACHINE CHECK 0 0 0) 0 


OBR 3 0 0 2 1 
OBRSHT 0) 0 0 0 0 
OBRDMT 0 0) 0 0 0 
OBREOD 0 0) 0) 0 0 
OBRDPA 0 0 0) 0) 0) 
OBRTMP 28 0 7 10 11 
OBRPRM 0 0 0 0 0) 
OUTBOARD ad 0) 7 12 12 
SFT 0 0 0 0 0 
SFTABN 4 4 0 0 0 
SF TMCH 0) 0 0) 6) 0 
SFTPI 13 6 7 0) 0 
SFTRST 0 0 0 0 0 
SOFTWARE 17 10 7 0 0 
IPL 0 0) 0 0 0 
SYSTEM INITIALIZATION 0 0) 0 0 0) 
DDR 0 0 0 0) 0) 
DDROPR 0 0 0 0 0 
DDRSYS 0 0 0) 0 0) 
SYSTEM RECONFIGURATION 0 0) 0 0) 0) 
EOD 0) 0 0 0) 0 
SYSTEM TERMINATION 0 0 0 0) 0 
MDR 2 0 0 0) 2 
MDRDAS 0 0 0 0 0 
BUFFER OFFLOAD 2 0) 0 0 2 
CCH 0 6) 0) 0 0 
CCHINC 0 0) 0) 0 0 
CCHCRH 0 0 0 0 0) 
CHANNEL CHECK ) 0 0) 0) 0 


Figure 2-6 (Part 1 of 2). Event History Summary 
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Event History Report 
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RECORD TYPES TOTAL CPU-A CPU-B CPU-C CPU-D 
MIH 0 0 0 0 0 
CHANNEL END 0 0 0 0 0 
DEVICE END 0 0 0 0 0 

MISSING INTERRUPT 0 0 0 0 0 


OVER ALL TOTALS 50 10 414 12 14 
RECORD TYPES TOTAL CPU-A CPU-B CPU-C CPU-D 
MISSING CSCH 0 0 ) ) 0 
MISSING HSCH ) 0 0 0 0 
IDLE DEVICE 0 0 0 0 0 
START PENDING 17 7 10 0 0 
MOUNT PENDING 0 0 0 ) 0 
MISSING PRI STATUS 0 0 0 0 0 
MISSING SEC STATUS 0 0 ) 0 0 
MISSING INTERRUPT 17 7 10 0 o 
HARDWARE 0 0 ) ) 0 
SOFTWARE 0 0 ) ) 0 
CHANNEL REPORTS 0 0 0 0 0 
CHPID-02 1 ) 1 0 0 
SUBCHANNEL LOGOUTS 1 ) 1 0 0 
OVER ALL TOTALS 68 17 #25 12 14 J 


CPU MODEL SERIAL NO. {fy 


3081 020015 
3081XA 020015 
3033 020863 
3033 020862 


0 OW YS 


Figure 2-6 (Part 2 of 2). Event History Summary 


Event History Report 


Notes: 


. 


RECORD TYPES. If 370 and 370-XA mode records are used, the records 
common to both modes are combined. Exception: 370-mode MIH records are 
totaled separately. 


OVER ALL TOTALS. These totals include only those records common to 370 
and 370-XA modes and the MIH errors for 370-mode records. 


MISSING INTERRUPT. These MIH errors are for 370-XA mode records. 


OVER ALL TOTALS. These totals include all errors recorded in both proc- 
essing modes. 


CPU information. Processors, identified from filtered data. XA indicates that 
the processor was running in 370-XA mode. 
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System Exception Reports 


Depending on the types of processor and I/O subsystems your installation has, the 
EREP System Exception reports can help you identify problems within those sub- 
systems. EREP produces System Exception reports for only some hardware sub- 
systems, however; see the product groups in Part 4, “Product-Dependent 
Information” for product subsystems included in the System Exception reports. 


When you code the SYSEXN report parameter for an EREP run, EREP analyzes 
hardware and software error records to produce a series of reports that provide 
information about how your installation’s hardware subsystems are working. 


You will want to set up additional controls for the System Exception reports, 
using the DASDID, LIMIT and SHARE control statements, before you actually 
request the report series. See the descriptions of the control statements in 
Chapter 8, “EREP Control Statements” and Part 4 for more information. 


The System Exception report series comprises several separate reports: a two-part 
System Error Summary, Subsystem Exception reports for each category of sub- 
system, and more detailed summaries for DASD and tape subsystems. 


For the Subsystem Exception reports and related summaries, EREP accumulates 
error data and, when available, usage statistics — as for a DASD or tape sub- 
system — and summarizes the information by component. 


In order to avoid reworking the same errors, and to make sure that the probable 
failing unit analysis is accurate, you should run the System Exception report series 
every day. See Chapter 4, “Running EREP” for examples of EREP runs that 
include daily System Exception reports. 


Care should be taken when specifying selection parameters other than DATE and 
TIME as report results could be misleading. 


System Error Summary Format 
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The System Error Summary presents processor (CPU) errors and channel checks 
in Part 1, and permanent DASD and tape errors in Part 2. Part | also includes a 
summary of IPL, EOD, and restart records, if present. The data is presented in 
chronological order. 


For each of the four sources of errors, the System Error Summary includes the 
probable failing unit (PFU). The PFU is the component (unit) on which EREP 
has determined that the error most likely occurred. 


The printed output for Part 1 is one page for each supported CPU in the installa- 
tion; Part 2 combines the I/O errors for all supported subsystems. EREP does 
not print out duplicates of records occurring together; see the example in 

Figure 2-7 on page 2-24. 


é 


J 


C 


System Exception Reports 


Subsystem Exception Report Formats 


EREP formats each of the Subsystem Exception reports according to the require- 
ments of the hardware involved. 


e The Processor Subsystem Exception report is organized around the service 
level indicators for termination, hard, and soft machine checks. For soft 
machine checks, the report shows the number of 60-minute intervals in which 
the LIMIT value was exceeded. See “LIMIT Control Statement” in 
Chapter 20, “Processors (CPUs).” 


@ The Channel Subsystem Exception report is organized according to the pos- 
sible source of channel checks: the channel, the storage control unit, and the 
controller. It shows the number of times each of these error types exceeded 
the LIMIT values for specific channels or controllers, and includes the 
60-minute exception count for each channel or controller. 


e The DASD Subsystem Exception report is organized by the probable failing 
units (PFUs), starting with the units closest to the processor and working 
toward the volume. (A DASD subsystem consists of a storage control unit, if 
present, a controller or storage director, and the string(s) of devices attached 
to the controller.) The units are ordered, within each PFU grouping, from 
that with the largest number of permanent errors to that with the smallest 
number of temporary errors. 


A probable failing unit is identified through the physical ID of the device. 
The physical ID is the combined identifiers of storage controller, control unit, 
and device. In order for EREP to recognize units common to different 
systems and to arrive at the correct PFUs, you must code DASDID control 
statements to establish physical IDs for those DASD in your installation that 
do not provide their own physical IDs. 


e The Tape Subsystem Exception report is organized by exception type — per- 
manent errors and temporary errors that exceeded the LIMIT values; and by 
the suspected source of the error — either hardware or the volume and the 
drive it was created on. A tape subsystem consists of a control unit and its 
string(s) of drives. 


Chapter 2. EREP Reports 2-2] 


System Exception Reports 


DASD and Tape Summaries 
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For DASD and tape subsystems, EREP also produces more detailed summaries of 


the errors shown in the Subsystem Exception reports. 


For DASD subsystems, the additional summaries present errors within the 
following categories: 


Symptom Code: lists the errors by fault symptom code within each PFU 
(probable failing unit) group. 


Data Transfer: further broken down according to whether the PFU is the 
volume or something other than the volume. 


Storage Control Unit (SCU): groups overruns under each interface 
between channel or subchannel and SCU. 


In addition, EREP produces two other reports for DASD that can be useful 
in determining the source of a DASD problem: 


The printout of Informational Messages could help you define a problem 
to IBM customer service personnel. 


The DASD String Summary could help you determine if a problem is 
unique to a particular device, or is also occurring on other devices in the 
controller string. 


For tape subsystems, the additional summaries group errors and sources as 
follows: 


Permanent Errors: lists them by CUA (or device number) and ~ 
volume/creating drive. 


Temporary Errors: lists a// temporary errors, regardless of whether or not 
they exceeded the LIMIT values and appeared in the Subsystem Excep- 
tion report. See “LIMIT Control Statement” in “34XX Tape Devices” in 
Part 4. 


DEVNO/CUA Statistics: reports on each device number or CUA 
appearing on the Subsystem Exception report, showing the breakdown of 
all activity recorded against it. 


Volume Statistics: lists all activity for all volumes that appeared on the 
Subsystem Exception report, by volume serial number (volid) in chrono- 
logical order. 


J 


System Exception Reports 


Figure 2-7 through Figure 2-21 are examples of the System Exception report 
output, in the order discussed here. Because the reports are hardware-specific, the 
output might not match what you see when you request the System Exception series 
for yourself. However, the general examples should help as you plan your EREP 
run. Following is the MVS JCL used to request the System Exception series. 


//SYSEXN EXEC PGM=IFCEREP1, PARM=(SYSEXN, 'DATE=(82347)', 
('ACC=N', 'TABSIZE=512K' , HIST) 

//TOURIST DD  SYSOUT=R 

//EREPPT DD  SYSOUT=R 

//DIRECTWK DD UNIT=SYSDA,SPACE=(CYL,5,,CONTIG) 

//ACCIN DD DSN=EREP . DAYLY.HISTORY , DISP=OLD 

//SYSIN DD DSN=CNTRL.STMTS .SYSEXN , DISP=OLD 

[DASDID, LIMIT, and SHARE statements for this report] 


Ye 
Specific fields and abbreviated headings are explained in the numbered notes fol- 


lowing each report example. For more detailed information about the various parts 
of the reports, see the maintenance documentation for the product involved. 
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SYSTEM ERROR SUMMARY 


(PART 1) 
MODEL 3033. SERIAL 020557 CPU A 
IPL/RESTART/TERMINATION [fq 
RECORD TIME SINCE 
TIME TYPE LAST ACTIVE 


DATE 347/82 


08:01:30:95 IPL 


15:23:09:29 TERM 
15:26:30:76 IPL 
19:15:56:22 RESTART 


PROCESSOR CHECKS [J 


TIME JOBNAME 
DATE 347/82 
08:40:55:52 N/A 
15:23:03:72 N/A 


CHANNEL CHECKS [J 


TIME JOBNAME 


DATE 347/82 


10:39:11:04 PAYROLL1 
13:11:18:64 JOBLOADA 
kk kkk 


13:14:33:09 JOBLOADA 


SYSTEM ERROR SUMMARY 
(PART 1) 


MODEL 3081XA SERIAL 020559 


IPL/RESTART/TERMINATION 


RECORD 
TIME TYPE 
DATE 347/82 
07:15:32:31 IPL-XA 


10:39:49:91 TERM-XA 
10:40:32:31 IPL-XA 


Figure 2-7 (Part 1 of 2). 
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09:01:29:56 NM 
MCH 
00:02:29:56 NM 


REPORT DATE 348 82 
PERIOD FROM 347 82 
TO 347 82 


REASON PROBABLE CAUSE 


NORMAL SYSTEM INITIALIZATION 
FORCED TERMINATION 

NORMAL SYSTEM INITIALIZATION 
RESTART ABEND CODE 071 


PROBABLE 
CUA/TYPE ERROR DESCRIPTION FAILING UNIT 
N/A BUFFER ERROR PROCESSOR 
N/A REGISTER/PSW INVALID PROCESSOR 
PROBABLE 
CUA/TYPE ERROR DESCRIPTION FAILING UNIT 
0384/3330 CHANNEL CONTROL CHECK CHANNEL 
0233/3380 INTERFACE CONTROL CHECK CONTROL UNIT 


0233/3380 


cpus fq 


TIME SINCE 
LAST ACTIVE 


12:10:52:16 NM 
EOP 
00:01:10:16 NM 


2 DUPLICATE LINES WITHIN THIS TIME INTERVAL HAVE NOT BEEN PRINTED 
INTERFACE CONTROL CHECK 


CONTROL UNIT 


REPORT DATE 348 82 
PERIOD FROM 347 82 
TO 347 82 


REASON PROBABLE CAUSE 


NORMAL SYSTEM INITIALIZATION 
IOS ERROR 
NORMAL SYSTEM INITIALIZATION 


System Error Summary (Part 1) 


SYSTEM ERROR SUMMARY 
(PART 1) 


MODEL 0158 SERIAL 02 


IPL/RESTART/TERMINATION 


RECORD 
TIME TYPE 
DATE 347/82 
08:01:30:52 IPL 
PROCESSOR CHECKS [fj 
TIME JOBNAME 
DATE 347/82 
18:40:55:52 N/A 
CHANNEL cHEcks [fj 
TIME JOBNAME 


DATE 347/82 


System Error Summary 


REPORT DATE 348 82 
PERIOD FROM 347 82 


TO 347 82 
3123 cPpuc 
TIME SINCE 


LAST ACTIVE REASON PROBABLE CAUSE 


19:01:32:16 NM NORMAL SYSTEM INITIALIZATION 


PROBABLE 


CUA/TYPE ERROR DESCRIPTION FAILING UNIT 


N/A BUFFER ERROR PROCESSOR 
PROBABLE 
CUA/TYPE ERROR DESCRIPTION FAILING UNIT 


CHANNEL CONTROL CHECK 


CHANNEL 


10:39:11:04 TEST12GS 0194/3330 


Figure 2-7 (Part 2 of 2). System Error Summary (Part 1) 


System Error Summary, Part 1 


Part 1 of the System Error Summary is a chronological listing of all machine 
checks and channel checks and, if applicable, IPL, restart (software), and termi- 
nation records. 


Notes: 
I. CPU information. The report is generated by CPU. This line contains the 
CPU model and serial numbers and a letter indicator that corresponds to the 


CPU letter indicators used throughout the System Exception reports. XA fol- 
lowing the model number indicates the processor was running in 370-XA mode. 
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System Error Summary 
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IPL/Restart/Termination section. This section presents records of system 
events. It appears only when the operating system is MVS or VSE/Advanced 
Function. The columns headed by REASON and PROBABLE CAUSE contain 
IPL reason code/restart abend code/reason code, and a brief explanation of the 
code. The IPL reason codes are included in Figure 10-11 in 

Chapter 10, “Error Records for EREP” ; the possible termination reason codes 
are: 


EOD  End-of-day record 
MCH Machine check forced termination. Non-restartable. 
EOP End of processing from IOS. Restartable wait state. 


PROCESSOR CHECKS. This section appears when EREP encounters MCH 
records. If the JOBNAME field is blank, the failure is within an operating 
system task. 


Possible ERROR DESCRIPTIONS are: 


HIR SUCCESSFUL 

POWER WARNING 

INVALID LOGOUT 

SYSTEM DAMAGE 
INSTRUCTION PROCESSOR 
HARD STORAGE ERROR 
STORAGE PROTECT KEY ERROR 
REGISTER OR PSW INVALID 
EXTERNAL DAMAGE 
BUFFER ERROR 
UNDEFINED ERROR 


Possible PROBABLE FAILING UNITS are: 


UNPROCESSED ENTRY 
PROCESSOR 

CHANNEL 
CHANNEL/DIRECTOR 
STORAGE 

CONTROL UNIT 
UNDEFINED 


CHANNEL CHECKS. This section appears if EREP encounters CCH 
records. If the JOBNAME field is blank, the failure is within an operating 
system task. 


Possible ERROR DESCRIPTIONS are: 


INTERFACE CONTROL CHECKS 

CHANNEL CONTROL CHECKS 

CHANNEL CONTROL/INTERFACE CONTROL CHECKS 

CHANNEL DATA CHECKS 

CHANNEL DATA/INTERFACE CONTROL CHECKS 

CHANNEL DATA/CHANNEL CONTROL CHECKS 

CHANNEL DATA/CHANNEL CONTROL/INTERFACE CONTROL CHECKS 


Possible PROBABLE FAILING UNITS are the same as those appearing in the 
processor section of the report. 


ww 


System Error Summary 





SYSTEM ERROR SUMMARY REPORT DATE 348 82 
(PART 2) PERIOD FROM 347 82 
TO 347 82 
PHYSICAL PHYSICAL ERROR PROBABLE 
TIME JOBNAME CPU ID TYPE ADDRESS PATH VOLUME ERROR DESCRIPTION FAILING UNIT 


DATE 347/82 


10:11: 
10:31; 
11:41: 


12:06 
13:16 
16:06 


18:25 
19:00 


22:05: 
:00: 


22:10 


Figure 


ll: 
ll: 
22: 
:40 
u22% 
:40 
18:10: 
:02 
:00 


05 


10 


11 
12 
13 


:00 


10 


:O1 
749 
:49 
:03 
:O1 


04 


2-8. 


DASDO001 B- N/A 3830 0372 00-0373 663E02 PERMANENT BUS OUT PARITY CHECK UNDETERMINED 
DASDOOO1 B 04-XX-XX 3880 02C4 01-02C4 57ST02 PERMANENT BUS OUT PARITY CHECK scu 

DASDO002 B- N/A 3830 0372 02-0373 TESTO2 PERMANENT EQUIPMENT CHECK UNDETERMINED 
PERM101 B N/A 3410 0685 04-0685 ABC123 LOAD POINT VOLUME/CD 
PRIV1O1l B N/A 3430 0880 13-0880 PAYROL N/A VOLUME/CD 
PRIV221 A N/A 3420 882 882 MASTER LO ROS/IC/BC MP2 HARDWARE 
TRENDSO] C N/A 3480 A80 ASO TPCTRL N/A HARDWARE 
370DXC1l1 B N/A 3480 0581 06-0581 370DXA N/A HARDWARE 
PAYROLLF A N/A 34XxX 9B6 N/A FICAO1] DDR INDICATES SWAP TO PCUA 9B3 N/A 

PAYROLLG A N/A 34xXX 98F N/A FICAO2 DDR INDICATES SWAP TO PCUA 98C N/A 
ATTEND12 B- N/A 34XxX 0127 N/A ATTEND DDR INDICATES SWAP TO DEVNO 0128 N/A 


System Error Summary (Part 2) 


System Error Summary, Part 2 


Part 2 of the System Error Summary is a chronological listing of permanent 
DASD and tape errors and DDR calls. 


Notes: 


1. PHYSICAL ID. For DASD providing physical ID or DASDID statements, this 
field contains some combination of SCUID-CTLID-DEVID, depending on the 
probable failing unit. (See “Subsystem Exception Report Formats” on 
page 2-21.) The field contains N/A for tape or for DASD without physical ID 
or DASDID statements. 


2. ERROR DESCRIPTION. Subsystem-dependent information. The DDR swap 
description appears in this field. 


3. Possible PROBABLE FAILING UNITS are: 


CHAN (CHANNEL) 

SCU (STORAGE CONTROL UNIT) 

CONTROLLER 

DEVICE 

VOLUME (FOR DASD) OR VOLUME/CD (FOR TAPE) 
UNDETERMINED 

UNKNOWN 

HARDWARE 


A PFU of N/A appears in the case of a DDR record. 
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SUBSYSTEM EXCEPTION 
PROCESSOR 


MODEL 3033 SERIAL 066666 CPU B 


TERMINATION ERROR 
SERVICE LEVEL INDICATOR 


POWER WARNING ee a en ae ae 
INVALID LOGOUT So eta, oo teh: 


HARD ERROR 
SERVICE LEVEL INDICATOR 


REGISTER/PSW INVALID a se 2 
HARD STORAGE ERROR fat 4s 
SYSTEM DAMAGE . 
INSTRUCTION PROCESSOR DAMAGE . 
STORAGE PROTECT KEY ERROR : 


REPORT DATE 180 82 
PERIOD FROM 179 82 


TO 179 82 
TOTAL COUNT 
2 
. 2 


TOTAL COUNT 


NNN & OO 


SOFT MACHINE CHECK EXCEPTION COUNT 


SERVICE LEVEL INDICATOR 
EXTERNAL DAMAGE yet fet ae a 


BUFFER ERROR a ae ee ee ee ee 
HIR SUCCESSFUL on ee geet at abe! BP i 


LIMITS APPLIED EXTD=01, BUFE=01,HIRS=01 
O UNIT(S) EXCLUDED DUE TO LIMITS 


20 MCH RECORD(S) PROCESSED 


60 MINUTE REFERENCE TOTAL COUNT 


2. eo tog 4 

Be. lel 2 

or me ae 1 
5 | 


1 MCH RECORD(S) UNDEFINED TO MCH ALGORITHMS 6 


Figure 2-9. Processor Subsystem Exception Report 
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DATE/TIME OF LAST 


179/82 
179/82 


11:23:45 


23:24:35 


DATE/TIME OF LAST 


179/82 
179/82 
179/82 
179/82 
179/82 


13:25:46 


ERROR 


237 
:87 


ERROR 


757 
13:35:58: 
14:34:34: 
11:43:45: 
11:23:45: 


77 
87 
47 
37 


DATE/TIME OF LAST ERROR 


179/82 
179/82 
179/82 


13:35:58:77 
17:54:45:87 
12:22:33:46 


Subsystem Exception Reports 


C Processor Subsystem Exception Report 
Notes: 


I. SERVICE LEVEL INDICATOR. May be: 


TERMINATION ERROR 
HARD ERROR 
SOFT MACHINE CHECK 


2. TOTAL COUNT. The actual count of input records containing this particular 
error. 


3. DATE/TIME OF LAST ERROR. Date and time from the last MCH record 
that included this error. If the date and time are the same for several service 
level indicators, it means that a single record included all the indicators. 


4. EXCEPTION COUNT. The number of unique 60-minute intervals that had at 
least the LIMIT value number of this kind of soft machine check. 


5. LIMITS APPLIED. The LIMIT values applied to this report. 


Note: If the LIMIT value is zero, the EXCEPTION COUNT field is also 
zero. 


6. Execution-time notes. These may be: 
= nn UNITS EXCLUDED DUE TO LIMITS (Jf LIMIT values are present) 


nn MCH RECORDS UNDEFINED (Not identifiable to EREP as valid MCH 
records) 


nn MCH RECORDS IGNORED DUE TO CCH DUPLICATION (0158 models only, 
from which MCH records might be double-reporting an assumed channel 
failure.) 


7. This space is used for self-explanatory SCP- and device-dependent messages 


specific to this Subsystem Exception report. For example: 
**WARNING** REPORT SPANS MORE THAN 3 DAYS. 
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SUBSYSTEM EXCEPTION REPORT DATE 180 82 
CHANNEL PERIOD FROM 179 82 
TO 179 82 


MODEL 3033 SERIAL 066666 CPU B 


SERVICE LEVEL INDICATOR EXCEPTION COUNT TOTAL COUNT DATE/TIME OF LAST ERROR 
60 MINUTE REFERENCE 


CHANNEL ERROR 


CHANNEL 6XX 3 4 179/82 18:47:38:67 

CHANNEL 1XX 1 1 179/82 21:22:23:43 

CHANNEL 2XX 1 1 179/82 11:34:43:65 

CHANNEL 8XX 1 1 179/82 11:43:32:87 
DIRECTOR ERROR 

DIRECTOR #1 1 1 179/82 19:32:54:89 

DIRECTOR #2 1 1 179/82 13:25:46:57 

DIRECTOR #3 1 1 179/82 11:24:36:57 
CONTROL UNIT ERROR 

CONTROL UNIT 34X 1 1 179/82 13:25:44:57 

CONTROL UNIT 456 1 1 179/82 13:32:22:37 


LIMITS APPLIED CHAN=01,DRCT=01,cTRL=01 [J 
O UNIT(S) EXCLUDED DUE TO LIMITS 


2 CCH RECORD(S) UNDEFINED TO CCH ALGORITHMS 
2 CCH RECORD(S) IGNORED BECAUSE OF MCH DUPLICATION 16 


Figure 2-10. Channel Subsystem Exception Report 
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C Channel Subsystem Exception Report 
Notes: 


I. SERVICE LEVEL INDICATOR. May be: 


CHANNEL ERROR (31XX/303X) 
CHANNEL STORAGE ERROR (31XX) OR DIRECTOR ERROR (303X) 
CONTROL UNIT ERROR 


2. EXCEPTION COUNT. The number of unique 60-minute intervals that had at 
least the LIMIT value number of this kind of channel check. 


3. TOTAL COUNT. The actual count of input records containing this particular 
error. 


4. DATE/TIME OF LAST ERROR. Date and time from the last CCH record 
that included this error. If the date and time are the same for several service 
level indicators, it means that a single record included all the indicators. 


5. LIMITS APPLIED. The LIMIT values applied to this report. 


Note: If the LIMIT value is zero, the EXCEPTION COUNT field is also 
zero. 


6. Execution-time notes. These may be: 
wt nn UNITS EXCLUDED DUE TO LIMITS (If LIMIT values are present) 


nn INPUT RECORDS UNDEFINED (Not identifiable to EREP as valid CCH 
records) 


nn CCH RECORDS IGNORED DUE TO MCH DUPLICATION (The number of 
0158 or 0168 channel storage errors, or 303X channel errors, ignored 
because they might be double-reporting a processor storage error.) 


nn CCH RECORD(S) FOUND GENERATED FOR SOFTWARE RECOVERY (The 
number of sympathetic channel errors found; for 303X only.) 


7. This space is used for self-explanatory SCP- and device-dependent messages 


specific to this Subsystem Exception report. For example: 
**WARNING** REPORT SPANS MORE THAN 3 DAYS. 
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SUBSYSTEM EXCEPTION 
DASD 


REPORT DATE 179 82 
PERIOD FROM 173 82 
TO 174 82 


B-BUS OUT PARITY CHK C-CHECK DATA CHK D-DISKETTE CHK I-INVOKED OFFSETS 


PROBABLE ---IMPACT OF TEMPORARY ERRORS--- ---USAGE--- 
FAILING FAILURE PHYSICAL ---TOTALS--- EQU 1000 ~=MB. 
UNIT AFFECT CPU ADDRESS PERM TEMP CHK SKS RD OVRN OTHER SKS READ 
~-------------4--------+----- $n nn pn a po en pn nn tan nn po en nn tn = ft 
AE 6 5 | 6 | 8 | 9 | 
pee eee eee ee eee eee eRe eS E Eee EEE ES EERE EE EERE EEE SESE SEER ESE SESE ESE EEE SESE ERE SESE SESSLER EEE ESE SESESERSESESESES ESE 
CHAN O1XX CHAN/SCU TOTAL 1 N/A N/A 
B 21-XX-xX 1 118 3204 
01 CHAN/SCU TOTAL 1 N/A N/A 
A 0121 1 65 4294 
-------------- poe non $$ np ee pp ef ep = + 
** WARNING ** INVALID PHYSICAL ID ON NEXT LINE 
SCU 01-XX-XX CHAN/SCU TOTAL 1 N/A N/A 
3880 B 01-XX-xx i 59 +=. 268 
EO-XX-XX SCU TOTAL 1 N/A N/A 
3830 B 0123 1 64 4026 
-------------- fawn nnn pan nnn fn nn nn | nn pn nnn on nnn nn pe pp et 
CTLR XX-03-XX CTLR TOTAL 1 1 N/A N/A 
3375 B 21-03-04 1 1 58 251 
XX-E2-XX CTLR TOTAL 1 i N/A N/A 
3330 B 0125 1 1 63 3758 
-------------- pr an pn an pan nn nn nn an pn npn nn pan nn pan nn en pan ep $e = = + 
DEV XX-E2-07 DATAXFR TOTAL 2 2 N/A N/A 
3330 B 0127 2 2 62 3489 
XX-03-04 SEEK TOTAL 1 1 N/A N/A 
3375 B 21-03-04 1 i 58 251 
-------------- onan ff ep en np nn pn en ne pe et 
VOL VOLO02 DATAXFR TOTAL 1 N/A N/A 
3375 B 21-14-04 1 60 2952 
VOLO01 DATAXFR TOTAL 1 1 N/A N/A 
3330 A 0121 1 1 65 4294 
woo ----------- foo $f np pn nn nn nn tan nn pn pn nn pn tt 
** WARNING ** NO DASDID CARD FOUND OR INVALID PHYSICAL ID - PROBABLE UNIT NOT ASSIGNED FOR THE FOLLOWING: 
DATAXFR TOTAL 1 1 N/A N/A 
3330 B -*0223 1 1 57 234 
~------------- $o-------4----- 4 -- - - 5p on np oe nn pn nnn pin nn pan nt on en penne nn fo f= = + 
UNK UNKNOWN TOTAL N/A N/A 
3830 B  *0139 
KEKE KKKKKKEKEKKEKKKKKKEKEKKERKRKKEKKKAKKEKKEKREKKKKKAKKEKKKKEKAKKHKEKKEREKEKKEKKKKREKKRKKKEKKRKKKEKKKKKKRKKRKKKKRKR KKK KKK 
0 UNIT(S) EXCLUDED DUE TO LIMITS 
CPU MODEL SERIAL NUMBER [KJ 
A 3081XA 020097 
B 3033 020557 


** ENTRIES WITH AN ASTERISK INDICATE THAT DASDID CARDS WERE NOT FOUND FOR THE UNIT. 


NOTE: "IMPACT OF TEMPORARY ERRORS" IS THE NUMBER OF TIMES ERROR THRESHOLD HAS BEEN EXCEEDED. 
NOTE: BLANK ENTRIES INDICATE ZERO VALUES OR NOT APPLICABLE. N/A NOT AVAILABLE. 
NOTE: ZERO ENTRIES INDICATE RECORDS EXIST IN EREP REPORTS BUT THRESHOLDS WERE NOT EXCEEDED. 


Figure 2-11. DASD Subsystem Exception Report 
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DASD Subsystem Exception Report 


This report can be used to determine if the DASD subsystem has excessive errors 
or is operating within acceptable limits. You can specify LIMIT controls to 
prevent the printing of excessive temporary errors. See “LIMIT Control 
Statement” under “33XX DASD” in Part 4. 


The DASD exception report is organized by probable failing unit from channel to 
volume; within each section, the PFUs are ordered from most permanent errors to 
fewest temporary errors. 


If this exception report indicates that corrective action is necessary, the DASD 
reports that follow provide the details needed for correction. See Figure 2-12 
through Figure 2-16. 


Notes: 


1. This space is used for self-explanatory SCP- and device-dependent messages 


specific to this Subsystem Exception report. For example: 
**WARNING** REPORT SPANS MORE THAN 3 DAYS. PFU ANALYSIS 
MAY BE IN ERROR. 


2. Definitions of the suffixes for the counters that can appear in the OTHER column 
under IMPACT OF TEMPORARY ERRORS. 


3. PROBABLE FAILING UNIT. The PFU is the unit most likely to be the 
source of the failure; the actual failure could be recorded against another unit or 
units. EREP identifies the PFU based on the failure affect and the units 
reporting errors. The accuracy of this analysis for devices without physical ID 
depends on DASDID control statements. The possible PFUs are: 


CHAN Channel (channel, program, or CPU) 
SCU Storage control unit (3830, FTA, ISC, for example) 
CTLR Controller (drive string controller, or something common to more 


than one device on the string ) 


MULTIPLE Failure common to more than one device. 


DEV Device (addressable unit) 
VOL Volume (data on volume ) 
UNK Unknown (cannot be determined by report algorithms) 


If no DASDID entry exists, or the physical ID is invalid, a warning message 
replaces the PFU line. 


In the line for PFU are its identifier, the failure affect, and the total errors 
attributed to this combination of PFU and failure affect. Usage counts are not 
available (N/A) because the total usage of the device is not determined in gen- 
erating the report (non-failing devices are not considered). 
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4. PFU identifier. An identifier appears for each PFU. Their formats are as 
follows: J 


CHAN '- Channel 


02XX 02 is the channel address from the SCUAs reporting the 
failures. 
01 In 370-XA mode, the channel path ID. 
SCU Storage Control Unit 
SS-XX-XX 


CTLR Controller 


XX-CC-XX 
DEV Device (the addressable unit) 
XX-CC-DD 
where: 
SS storage control unit/director ID 
CC controller ID 
DD physical device ID. 
VOL nnnnnn (The volume serial number from the OBR/MDR device- J 


dependent VOLID field.) 
When information in the DASDID is not adequate, the format is 


(*nnnn), where * indicates that DASDID information was inadequate 
and nnnn is the PCUA or device number. 
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FAILURE AFFECT. This field defines the function or machine area affected 
by the failure. The possible failure affects are: 


CHAN/SCU The channel, CPU, or program, or the channel/storage 
control unit interface. 


SCU The storage control unit. 

SCU/CTLR The storage control unit/controller interface. 

CTLR The controller. 

CTLR/DEV The controller/device interface. 

MULTIPLE Failure common to more than one device. 

DEV The device, including problems with a volume that must be 


handled by a service representative. 


SEEK The function of accessing the track; the failure may be in 
the controller, the drive, or the volume. 


DATAXFR Data transfer: the function of reading or writing data; the 
failure may be in the controller, the drive, or the volume. 


DATAXFR(HDA) Data transfer, where the failure is in the head disk 
assembly. 


UNK Unknown, it is possible that two failures exist, providing 
conflicting information. 


CPU. The report is limited to 16 CPUs. 


PHYSICAL ADDRESS. The physical address is the means for locating infor- 
mation on other EREP reports. For devices providing physical IDs, the physical 
ID is used. For non-physical ID devices, the address is the PCUA (its physical 
address) or device number. 


TOTALS. 
PERM ~ The count of permanent errors recorded against the unit and totaled for 
the PFU within the given failure affect. (A permanent error is indi- 


cated by a zero temporary error bit in the OBR record.) 


TEMP The sum of the counts shown for the line under \MPACT OF TEMPORARY 
ERRORS. 
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9. 


10. 


11. 


12. 


13. 


14. 


IMPACT OF TEMPORARY ERRORS. These fields indicate the number of 
temporary errors when the count exceeds a LIMIT value. Definitions of the 
counts of temporary errors are in the DASD maintenance manual. Types of 
temporary errors are: 


EQU CHK Temporary equipment checks 


SKS Temporary seek checks 


RD Temporary data checks during reading, corrected by retrying or by 
ECC (error correction code). 


OVRN Overruns (only applicable to a PFU of CHAN and if system 
retried). See “DASD Storage Control Unit Summary” on 
page 2-46 for total overrun count. 


OTHER All other temporary errors. The types are identified by the letter 
suffix; in the case of multiple error types, multiple letters follow the 
counter. 


USAGE. The usage figures are in units of one thousand for seeks and mega- 
bytes for data read. 


**WARNING** INVALID PHYSICAL ID. This message appears when 
EREP detects an SCUID of X’00’ or X’0I' or a CTLRID of X00’ or X' FF. 
In these cases, devices might be included in the report under a PFU of CHAN, 
SCU, or CTLR showing only 0 or null for temporary errors. 


Device type. 


UNIT(S) EXCLUDED DUE TO LIMITS. You can limit the amount of 
printed output by preventing the printing of PFUs with fewer temporary errors 
than the limits defined on LIMIT statements. See “LIMIT Control Statement’ 
on page 15-5. When such limits are in effect, and some PFUs would have been 
printed were the limits not in effect, EREP prints a message at the end of the 
report stating the number of PFUs not printed and the LIMIT values in effect. 


Note: Use of the LIMIT control statement is not valid for 9332 and 9335 
devices. 


XA following the CPU model number indicates that the processor complex was 
running in 370-XA mode. 


DASD Itiformational Messages ) 





DASD INFORMATIONAL MESSAGES REPORT DATE 363 82 

PERIOD FROM 362 82 

TO 363 82 

PHYSICAL SYMPTOM 
ID CODE COUNT MESSAGE 
TEER RRSESE SRE RSE SESE REAEESE EEE SELES EEE REESE SERRE PERE RSE SESE RL EL ESL EL ERE SEES RES ER ERE REEL ES SE 
02-03-01 1010 1 SECTOR RETRY THRESHOLD EXCEEDED RBN 33694 
02-03-01 1313 1 THRESHOLD LOGGING COMPLETE FOR EQUIPMENT CHECKS 
02-03-01 1616 1 THRESHOLD LOGGING COMPLETE FOR SEEK CHECKS 
02-03-01 1919 1 THRESHOLD LOGGING COMPLETE FOR DATA CHECKS 
02-03-01 2121 1 ALTERNATE BLOCKS NEARLY EXHAUSTED 
06-XX-XX N/A 1  SD/SD TEST FAILED AT IML 
06-XX-XX 3A00 1 TRACE SAVED FOR STORAGE DIRECTOR 
14-XX-XX N/A 1 SD/SD TEST FAILED AT IML 
22-23-01 101F 1 SECTOR RETRY THRESHOLD EXCEEDED RBN 260753 
22-23-01 2072 1 CALL FOR SERVICE 
40-XX-XX OOOF 2 THRESHOLD LOGGING COMPLETE FOR SUBSYSTEM STORE CHECKS 
40-40-xx 0002 2 THRESHOLD LOGGING COMPLETE FOR DATA CHECKS WITHOUT OFFSET 
40-40-04 0001 2 THRESHOLD LOGGING COMPLETE FOR SEEK CHECKS 
40-40-04 0003 2 THRESHOLD LOGGING COMPLETE FOR DATA CHECKS WITH OFFSET 


Figure 2-12. DASD Informational Messages 


DASD Informational Messages 


This report provides information for the hardware service representative. The 
records involved are not standard sense records resulting from an error condition; 
rather, they may relate to a hardware failure that could degrade performance. 


The DASD informational messages appear automatically following the DASD 
Subsystem Exception report. 


Note: Information about the actions required for the various messages is in the 
maintenance library for the device identified in the first field. 
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DASD Subsystem Summaries 


The next several pages present examples of the various DASD summaries 


included in the System Exception report series. The records and events covered in 
the summaries are the same ones that appear on the DASD Subsystem Exception 


report. 


Corresponding summaries for the 34XX tape subsystem follow the “Tape Sub- 


system Exception Report” on page 2-47. 


DASD STRING SUMMARY REPORT DATE 188 83 
PERIOD FROM 061 83 
TO 090 83 
STRINGS WITH ANY DRIVE REPORTED ON THE SUBSYSTEM EXCEPTION DASD REPORT 
WITH PHYSICAL ID FROM DASDID CONTROLS OR FROM DEVICE SENSE RECORD AND 
FAILURE AFFECTS OF: CTLR, CRLR/DEV, DEV, SEEK, OR DATAXFR 


ERROR TYPES SEEK MEGABYES 
EQU. |SEEK |DATA ACCESSES MEGABYTES WRITTEN 
PHYSICAL ID VOLUME  CHKS | |XFER _X 1000 READ W/VERIFY 
KHEKEKEKCKKEKEEEEKEKEEKEKEKEKEKEEEKEKHEEEKKEEREEEKEEEKEKEEKEKREKKKEREKEKKKKEKKKKKKK 
XX-1C-02 PAK181 Y 
XX-1E-02 SPOOL2 Y 1 | 
XX-12-00 PAK105 Y 
04 PAK109 Y 
XX-16-04 PAK117 Y 
XX-20-02 PAK162 Y 
XX-22-00 PAK187 Y 
XX-80-00 MVS120 40 3612 
01 MVS130 39 3605 
02 MVS150 38 174 
03 MVS160 45 202 
04 IBM354 
05 TBM355 Y 
06 IBM356 
07 IBM357 
XX-84-00 CPDSKB Y Y 
01 PAK164 Y 
04 PAK167 Y 
06 PAK169 Y 
ALL DASD PROCESSED FOR EXCEPTION REPORT 479 10146 


REECE EREEEEEEEKEKRKREREEERKEEEEKREEKEEKKEEAKEKKKKEKEKKKKKKKRKKK 


CPU MODEL SERIAL NUMBER 

A 3081 220402 

B 3081 020402 

C 3081 020033 EI 
D 3081 020631 

E 3081 020063 

F 3081 220063 

G 3081 220631 

H 3081 220033 


NOTE: THE COUNTS FOR SEEK ACCESSES x 1000, MEGABYTES READ, AND 
MEGABYTES WRITTEN W/VERIFY ARE SIX DIGIT POSITIONS. IF THE 
SPACE IS EXCEEDED, THE COUNT IS DIVIDED BY 1000 AND A K IS 
PLACED AT THE END OF THE NUMBER. IF THE COUNT IS EXCEEDED 
WITH A K AT THE END, 99999K WILL BE PRINTED. 


Figure 2-13. DASD String Summary 
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DASD Subsystem Summaries 


The usage information in the DASD String Summary can help you determine 
whether a failure affect reported in the DASD Subsystem Exception report is 
unique to a particular drive or is common to more than one device in the same 
controller string. The String Summary is in three parts. 


Notes: 


1. 


The first part shows failure affect and usage data for each unique combination 
of volume and physical ID belonging to every controller string that appeared on 
the Subsystem Exception Report with one of the following failure affects: 


CTLR 
CTLR/DEV 

DEV 

SEEK 

DATAXFR 
DATAXFR(HDA) 
MULTIPLE 


The first three of these failure affects are grouped under the heading of 
EQU.CKS; SEEK and DATA TRANSFER errors are noted under their own 
headings. 


The usage data for each volume/physical ID appears under three possible 
headings: 


@ SEEK ACCESSES X 1000 
@ MEGABYTES READ 
@ MEGABYTES WRITTEN WITH VERIFY 


However, without valid physical [Ds for the devices, or relevant failure affect 
data from the exception report, or usage data for the selected devices, EREP 
cannot generate a DASD String Summary. In these cases, the first part of the 
report is replaced by a message explaining the absence of report data. 


The second part of the String Summary shows the usage statistics for ALL 
DASD processed for the Subsystem Exception report, regardless of failure 
affect, physical ID, and whether any failures were reported. 


The third part of the summary shows all CPUs processed for the exception 
report, by letter identifier, model number, and serial number. 
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DASD SYMPTOM CODE SUMMARY REPORT DATE 179 82 


PERIOD FROM 173 82 
TO 174 82 


a BY PROBABLE FAILING UNIT a 
SYMPTOM PHYSICAL OCCUR- FAILURE DATE AND TIME OF 
CODE ID RENCES AFFECT FIRST OCCURRENCE LAST OCCURRENCE 
SENSE FROM FIRST OCCURRENCE 
DEVICE 0000 0000 0011111311111 2222 
TYPE PRM/TMP 0123 4567 89012345 6789 0123 
8 | 
PHYSICAL ERROR 
ADDRESS PATH CPU(S) 


KHAEKAEKEKEKEKEKEKEKKEREKKEKCEKEEEEKKKEKEAEKEEEEKEKERKKKEKKEEKREKEEKREREKKEKEKEKKEEKKKARKESE 


PROBABLE FAILING UNIT: CHANNEL +9939 rr rrr rr rrr rrr rrr rrr rrr rr teers 
a BY SCUID, SYMPTOM ‘CODE -===-=-=---<-+<2-->+---= fa I a a 
OFOl * 21-XX-xXX 1 O CHAN/SCU 174/82 08:10:30:07 174/82 08:10:30:07 
3880 eee 04050607 08091011 12131415 16171819 20210F01 
4 | 7 
21-XX-Xx — 012C A 
0901 *  EQ-XxX-xXX 1 O  CHAN/SCU 174/82 08:10:30:01 174/82 08:10:30:01 
3830 04010203 04050607 08091011 12131415 16171819 20210901 
0121 0121 A 
PROBABLE FAILING UNIT: STORAGE CONTROL UNIT--9- 3-3-7392 r ren rrr rrr ren 
SEQUENCE BY SCUID, SYMPTOM CODE restr rete ttre tert re ee re reese se cesses ssesesess= 
OFOl * 01-XxX-xXX 1 O  CHAN/SCU 174/82 08:10:30:08 174/82 08:10:30:08 
3880 04010203 0405063B 08091011 12131415 16171819 20010FO1 
01-XX-XX 012E A 
0908 *  EO-XxX-xxX 1 O- ScU 174/82 08:10:30:02 174/82 08:10:30:02 
3830 00010203 04050607 08091011 12131415 16171819 20210908 
0123 0123 A 
PROBABLE FAILING UNIT: CONTROLLER 33-33-33 3r rrr rrr rr rrr rrr rrr rrr sre 
SEQUENCE BY CTLID, SYMPTOM CODE wr rrr rrr rr rr rr rr rr rr rrr rrr 
191D *  XX-03-xX 0 1 CTLR 174/82 08:10:30:09 174/82 08:10:30:09 
3775 04010203 04050613 08091011 12131415 16171819 2021191D 
21-03-04 0134 A 
PROBABLE FAILING UNIT: NO DASDID CARD OR UNKNOWN =------9 rr rrr rrr rrr rr rrr errr 
SEQUENCE BY PCUA,. SYMPTOM CODE ==—-—=<==$s$-S—ss-8—=3<0035 639834555553 555=<<=>-- 
090B N/A 0 0 UNKNOWN 174/82 08:10:30:13 174/82 08:10:30:13 
3830 00010203 04050603 080°1011 12131415 16171819 20210908 
0139 0139 A 
191A * N/A O 1  DATAXFER 174/82 08:10:30:06 174/82 08:10:30:06 
3330 04011203 04050643 08091011 12131415 16171819 2021191A 
022B 022B A 
KEKKKKEKKEEKKKEKKEKKEKREKEKEEKKEKEKKKEKKKKEKEKKEKKERKKEKKKEKKKKAKKEKEKKEKKKKKKEK 
CPU MODEL SERIAL NUMBER 
A 3081XA 020097 
B 3033 020558 


NOTE: SYMPTOM CODES WITHOUT AN ASTERISK ARE INFORMATIONAL ONLY 
NOTE: PHYSICAL ID OF N/A MEANS THERE WERE NO DASDID CARDS 


Figure 2-14. DASD Symptom Code Summary 
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DASD Symptom Code Summary 


This report provides information required for hardware maintenance. Each sense 
(OBR) record reported in the exception report is listed by PFU, fault symptom 
code, and physical ID. 


The symptom code is to be used with the maintenance procedures for the device. 
The report allows the service representative to locate the failures noted in the 
DASD Subsystem Exception report and to note the symptom code and first sense 
record for each failure. Data checks (symptom codes 4XXX and 5XXX), which 
appear in the DASD Data Transfer Summary, also appear here, for use when 
hardware repair is required. 


Notes: 


1. 


2. 


The overall sequence of this report is by probable failing unit. 


SYMPTOM CODE. A fault symptom code recorded for this PFU. All 
symptom codes except those for records collected in logging mode are followed 
by an asterisk (*). (Records collected in logging mode do not appear on the 
subsystem exception report.) The symptom code that appears for the format 5 
(ECC-correctable) OBR record is a dummy created by duplicating the contents 
of sense byte 7. (If sense byte 7=53, the symptom code is 5353.) 


In the report, the first line for each symptom code shows the code itself, the 
physical ID of the device, the count of permanent and temporary errors for that 
symptom code, the failure affect for that symptom code, and the date/time of 
recording the first and last sense records received for that symptom code. 


The second line of each entry shows the device type and the first sense record 
received for the particular symptom code. 


The following lines show the physical and logical addresses involved with 
recording the particular symptom code, and the CPU on which the record was 
created. 


PHYSICAL ID. For DASD providing physical IDs or DASDID statements, 
this field contains some combination of SCUID-CTLID-DEVID, 2 depending on 
the probable failing unit. For other devices, the field contains N/A. Refer to 
the DASD Subsystem Exception Reports PFU Identifier for the format of the 
physical ID. 


DEVICE TYPE. 


OCCURRENCES. The number of permanent and temporary errors encount- 
ered for this symptom code, this physical ID, and this failure affect. 


See the DASD section of Part 4, “Product-Dependent Information” for exceptions. 
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6. FAILURE AFFECT. This field defines the function or machine area affected 
by the failure. The possible failure affects are: 


CHAN/SCU 


SCU 


SCU/CTLR 


CTLR 


CTLR/DEV 


MULTIPLE 


DEV 


SEEK 


DATAXFR 


DATAXFR(HDA) 


UNK 


The channel, CPU, or program, or the channel/storage 
control unit interface. 


The storage control unit. 

The storage control unit/controller interface. 
The controller. 

The controller/device interface. 

Failure common to more than one device. 


The device, including problems with a volume that must be 
handled by a service representative. 


The function of accessing the track; the failure may be in 
the controller, the drive, or the volume. 


Data transfer: the function of reading or writing data; the 
failure may be in the controller, the drive, or the volume. 


Data transfer, where the failure is in the head disk assembly. 


Unknown, it is possible that two failures exist, providing 
conflicting information. 


7. PHYSICAL ADDRESS. Jf the device provides physical ID, this is the same as 
the physical ID. Otherwise, it is the PCUA or device number. 


8. ERROR PATH. The address from which the record was received. In 370-XA 
mode, the format is CHPID-device number (01-0120). 


9. DATE AND TIME. The date and time of the first and last occurrences of the 
sense records for this symptom code. 


10. CPU(s). The EREP-assigned CPU letter indicator. 


11, SENSE FROM FIRST OCCURRENCE. The first sense record received for 
this symptom code. There may be either 24 or 32 bytes of sense data. 
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DASD DATA TRANSFER SUMMARY REPORT DATE 176 82 
PROBABLE FAILING UNIT - VOLUME PERIOD FROM 173 82 
TO 174 82 


SENSE COUNTS 
TEMPORARY 
OFFSET INVK THRESHOLD 
PERM NO YES LOGGING 
RAEKKKEKKKKKKKEKEKKKKKKRKEKKRKKRKRKK KKK KKK KKK KKK KKK KKK KKK RK KKK KKK RK KKK KKK KKK 


SEQUENCE BY VOLUME LABEL. PHYSICAL ADDRESS, HEAD, CYLINDER 


2 | 
UNITADDRESS 0134 DEVTYPE 3375 VOLUME VOL002 
CPU A PHYSICAL ADDRESS XX-14-04 
FAILURE AT ADDRESS: CYLINDER 0005 HEAD 06 1 0 0 o 


LAST SENSE AT: 174/82 08:10:30:11 
04010203 04050643 08091011 12131415 16171819 20214941 
THE FOLLOWING ENTRIES HAVE ONLY MDR RECORD TYPES. THEREFORE, NO CYLINDER/HEAD EJ 
ADDRESSES ARE REPORTED. SEE THE EXCEPTION REPORT FOR THE ERROR COUNTS. 


UNITADDRESS 0121 DEVTYPE 3330 VOLUME VOLOO1 
CPU A PHYSICAL ADDRESS 0121 


DASD DATA TRANSFER SUMMARY REPORT DATE 176 82 
PROBABLE FAILING UNIT - OTHER PERIOD FROM 173 82 
TO 174 82 


SENSE COUNTS 
TEMPORARY 
OFFSET INVK THRESHOLD 
PERM NO YES LOGGING 


RAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKkKKKKkKKKkKKKkKKkkkkK KKK 


UNITADDRESS 0126 DEVTYPE 3330 VOLUME DEVOO1 
CPU A PHYSICAL ADDRESS 0127 


FAILURE AT ADDRESS: CYLINDER 0005 HEAD 06 0 1 0 o & 
LAST SENSE AT: 174/82 08:10:30:04 
00011203 04050643 08091011 12131415 16171819 2021191A 


UNITADDRESS 022A DEVTYPE 3330 VOLUME UNKOO1 
CPU A PHYSICAL ADDRESS 022B 


FAILURE AT ADDRESS: CYLINDER 0005 HEAD 06 0 1 0 0 
LAST SENSE AT: 174/82 08:10:30:06 
04011203 04050643 08091011 12131415 16171819 2021191A 


kKkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


CPU MODEL SERIAL NUMBER 
A 3081XA 020097 
B 3033 020558 


NOTE: CYLINDER/HEAD/BLOCK NUMBERS ARE DECIMAL VALUES 
NOTE: UNITADDRESS IS THE LOGICAL ADDRESS OF THE DEVICE 


Figure 2-15. DASD Data Transfer Summary 


Chapter 2. EREP Reports 2-43 








DASD Subsystem Summaries 


DASD Data Transfer Summary 
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This report lists each volume for which data checks appeared in the DASD Sub- 
system Exception report, giving the error locations for each. It can be in two 
parts: PFU of volume and PFU of other than volume. In general, 


e A PFU of volume implies that the first attempt at correction should be data 
correction by a utility program such as the Device Support Facility. 

e A PFU of other implies that the first attempt at correction should be per- 
formed by a service representative. See the JBM Disk Storage Management 
Guide - Error Handling for recommended actions. 

Notes: 

7. UNITADDRESS. The keyword used by the Device Support Facility to identify 
the device. It is the logical address (SCUA) or device number of the volume 
reporting the error. 

2. VOLUME. The volume serial number of the volume reporting the error. 

3. CPU. The CPU identified for the last sense record. 

4. PHYSICAL ADDRESS. For devices providing physical IDs, this is the phys- 
ical ID; for other devices, it is the PCUA or physical device number. 

5. FAILURE AT ADDRESS. The location of the data check. For count key 


data (CKD) devices, the “address” is expressed as cylinder and head; for fixed 
block (FBA) devices, it is expressed as block number. The values are in 
decimal. When a volume records data checks at more than one location, this 
report includes an entry for each location; they are in ascending order of the 
head/cylinder or block. 


LAST SENSE AT. The date and time of the last sense record received for this 
cylinder/head or block. The sense data precedes this line. There may be either 

24 or 32 sense bytes. The format of the sense record is in byte 7. For format-4 
records, the symptom code is in the last two sense bytes; for format-5 records, it 
is the value in byte 7 repeated. The date and time follow the sense bytes. 


SENSE COUNTS. These columns contain counts of the data checks for the 
particular cylinder/head or block. The permanent data checks appear in the 
first column. The temporary data checks are broken down as follows: 


@ OFFSET INVK (offset invoked) NO/YES indicates the number of temporary 
data checks that were recovered, and whether it was necessary to offset the 
access mechanism. 


® THRESHOLD LOGGING indicates the number of temporary data checks 
recorded when the device was in logging mode because the threshold for 
data checks was exceeded. 


J 


DASD Subsystem Summaries 


8. THE FOLLOWING ENTRIES ... In cases where the only error data is 
from error counters, meaning that failure addresses are not available, only the 
lines that define the device and volume appear. 
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DASD STORAGE CONTROL UNIT SUMMARY REPORT DATE 363 82 
PERIOD FROM 362 82 
TO 363 82 


RRR ERE REE ERE RE REE KERRIER KEKE KEKE REREREREREKREEKEEREKREKEKEKREKEEREKKEEE 
PHYSICAL ID 02-XX-XX DEVTYPE 3880 


OVERRUNS INTF-A INTF-B INTF-C INTF-D INTF-E INTF-F INTF-G INTF-H 


CMND 5 15 25 35 45 55 65 75 
DATA 10 20 30 40 50 60 70 80 
DISKETTE READER SEEK DATA 
TEMPORARY CHECKS 1 1 

PHYSICAL ID 04-XX-XxX DEVTYPE 3830 PHYSICAL ADDR 084X CPU(S) ABCD 


OVERRUNS INTF-A INTF-B INTF-C INTF-D 


CMND 10 30 5 120 
DATA 20 10 10 5 
PHYSICAL ID N/A DEVTYPE 3830 PHYSICAL ADDR 089X CPU(S) A 


OVERRUNS INTF-A INTF-B INTF-C INTF-D 
CMND 5 0 0 0 
DATA 80 0 0 0 


kkkkkkkhkkkkkkkkkkkkkkekkkkkkkkkkkkkkkakakkkkkkkkkhkkkkkkkekkkkkkekkkkkhekkkhkkkkkkkak 


CPU MODEL SERIAL NUMBER 


A 0168 060328 
B 4341 022222 
Cc 3081XA 012345 
D 3032 076543 


Figure 2-16. DASD Storage Control Unit Summary 


DASD Storage Control Unit Summary 


This report defines the physical channel interface over which overruns occurred 
for the 3830 and 3880 storage control units (SCU). 


Notes: 


I. INTF-A ... INTF-H. The Storage Control Unit channel interface. 
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Tape Subsystem Exception Report 


1 
( SUBSYSTEM EXCEPTION REPORT DATE 341 82 
TAPE PERIOD FROM 340 82 
TO 340 82 
acca ici as a a B420 (Sasa =sSe5e Se SSaaaaaa = (See 6410 Sea 
1600 BPI 6250 BPI 1600 BPI 
TEMP WRT(CT) TEMP RD(CT) TEMP WRT(CT) TEMP RD(CT) TEMP WRT(CT) TEMP RD(CT) 
CURRENT LIMITS HARDWARE 4 (15) 26 ( 2) 4 (15) 26 ( 2) 4 (15) 26 ( 2) 
eg VOLUME 4 (15) 26 ( 2) 4 (15) 26 ( 2) 4 (15) 26 ( 2) 
2 
c fH 
VOLUME DEVNO P EQU ---MB/ERR PERM--- ---MB/ERR TEMP--- BUS OVR TOTAL-MBYTES DEN- HDR 
EXCEPTION SERIAL /CUA U CHK READ(CT) WRITE(CT) WRITE(CT) READ(CT) OUT RUN I/O CNT READ WRITE SITY SER 
4 G 
HARDWARE 
PERMANENT ERROR 
O57X A O == ( 0) == ( 0) -- ( 0) 271 (21) 0 0 2M 5701 4391* -- 
0576 A 4 6( 2) -- ( QO) -- ( 0) == ( 0) oO 0 4K 12 11* 6250 


VOLUME OR CREATING DRIVE 
PERMANENT READ OR WRITE ERRORS OR RESET KEY ON MORE THAN ONE DRIVE 


773759 0571 A O O( 2) --( 0) --( 0) =-=-(0) oO 0 54 0 O* -- 03433 
VOLUME 
FAILED TEMPORARY READ OR WRITE LIMITS 
74347 0570 A O --( 0) --( 0) 1 (16) -- (0) 0 0 3K O 21* -- 
TOTAL NUMBER OF DRIVES ON REPORT 1 ( 108) TOTAL NUMBER OF VOLUMES USED = 76 
NOT ON REPORT 9 ( 908) TOTAL NUMBER OF VOLUMES LISTED = D) 
(*) AN AVERAGE BLOCK LENGTH WAS USED BECAUSE A ZERO BLOCK LENGTH WAS FOUND IN ONE OR MORE OBR RECORDS 
AVERAGE BLOCK LENGTH = 6324 
CPU MODEL = SERIAL NUMBER 
A 3081XA 020098 


Figure 2-17. Tape Subsystem Exception Report 


Tape Subsystem Exception Report 


This report indicates if the tape subsystem has permanent errors or is operating 
within acceptable limits. You can use LIMIT controls for both hardware and 
volume to prevent the printing of excessive temporary errors. See “LIMIT 
Control Statement” in the 34XX Tape Devices section of Part 4. 


Note: When you do not specify limits for temporary errors, only permanent errors 
appear on the Subsystem Exception report. 


If the Tape Subsystem Exception report indicates that corrective action is neces- 
sary, the summary reports that follow provide the details required for correction. 


The Tape Subsystem Exception report format and contents vary somewhat 
according to the device type involved. See Chapter 17, “Magnetic Tape Drives” 

C on page 17-1 for more information about specific products. The notes that 
follow are related to the report example in Figure 2-17. 
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Notes: 


1. 


This space is used for self-explanatory SCP- and device-dependent messages 
specific to this Subsystem Exception report. 


CURRENT LIMITS. These two lines show the limits set in LIMIT control 
statements included when the report was requested. The limits are set for tem- 
porary read and write errors occurring in the HARDWARE (device) and on the 
VOLUME. They prevent the printing of all temporary errors but those that 
occurred at the specified frequency level. These lines do not appear on the 
report for a 9347 device. Use of the LIMIT control statement is invalid for 
9347 devices. See “LIMIT Control Statement” on page 17-4 for details on 
using the LIMIT statement. 


In the tape reports, the current limits are grouped under device type (3420 and 
3410, in this example), tape density (1600 BPI and 6250 BPI), and TEMP 
WRT and TEMP RD. They show the specified number of megabytes read or 
written per error (MBYTES/ERR) and the specified total number of errors 
recorded (CT). In this report, for example, temporary write errors recorded 
against a 3420 drive (hardware) at a density of either 1600 or 6250 BPI will 
not appear as exceptions unless there are at least 15 errors occurring at a rate 
of 1 or more errors in each 4 megabytes of data written. Temporary read errors 
on a 3420 at either density will qualify as exceptions if there are 2 or more 
errors occurring at a rate of 1 or more errors in each 26 megabytes of data 
read. 


Tape Subsystem Exception Report 


3. EXCEPTION. Errors are presented in this report according to exception type; 
the type of exception serves as an indicator of the suspected source of the 
problem. There are five exception types listed on the Tape Subsystem Excep- 
tion report: 


a. HARDWARE — PERMANENT ERROR: All CUAs with a tape perma- 
nent error are listed here or under part 3c. If the CUA (ADDR) has an X 
as its last digit, the problem is likely to be with the control unit rather than 
the tape drive. Details of the permanent errors can be found in the Tape 
Permanent Error Summary, Figure 2-18. 


b. HARDWARE — FAILED TEMPORARY READ OR WRITE 
LIMITS: All CUAs with an error rate equal to or below the specified hard- 
ware limits are listed here. For more detail, see the Tape DEVNO/CUA 
Statistics Summary (Figure 2-20) and the Tape Volume Statistics 
Summary (Figure 2-21). 


c. VOLUME OR CREATING DRIVE — PERMANENT READ OR 
WRITE ERRORS OR RESET KEY ON MORE THAN ONE 
DRIVE:The volume indicated under VOLUME SERIAL has permanent 
errors on more than one drive. The problem could be with the tape itself, or 
with the drive where the tape was created. For more detail, see the Tape 
DEVNO/CUA Statistics Summary (Figure 2-20) and the Tape Volume 
Statistics Summary (Figure 2-21). 


d. VOLUME OR CREATING DRIVE — FAILED TEMPORARY READ 
OR WRITE LIMITS ON MORE THAN ONE DRIVE:The volume indi- 
cated under VOLUME SERIAL has an error rate equal to or below the 
specified volume MBYTE/ERROR limit on more than one drive. The error 
count LIMIT value is not used for this category of exceptions. The 
problem could be with the tape itself, or with the drive where the tape was 
created. For more detail, see the Tape DEVNO/CUA Statistics Summary 
(Figure 2-20) and the Tape Volume Statistics Summary (Figure 2-21). 


e. VOLUME — FAILED TEMPORARY READ OR WRITE LIMITS: All 
CUAs or device numbers that had a temporary error rate equal to or below 
the specified volume limits are listed here. The problem could be with the 
device or with the volume/tape. For more details, see the Tape 
DEVNO/CUA Statistics Summary (Figure 2-20) and the Tape Volume 
Statistics Summary (Figure 2-21). 


4. DEVNO/CUA. This column contains the device numbers or CUAs 
(channel/unit addresses) against which the permanent and temporary errors 
were recorded. 


5. EQU CHK. Count of equipment checks. 


6. MB/ERR PERM and MB/ERR TEMP. These columns list the actual numbers 
of errors recorded during the report period, and the actual error rate, for this 
CUA. For example, CUA 37E recorded 1 permanent read error in 28 mega- 
bytes of data read; CUA 9B8 recorded a total of 7 temporary write errors in 
164 megabytes of data written. 
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10. 


Il. 


12. 


13. 


14. 


BUS OUT. The bus out check count from the statistical data recorder (SDR) 
counters. 


OVR RUN. The overrun count from the SDR counters. 


I/O CNT. The number of START I/O instructions issued against this CUA 
during the report period, in thousands. 


TOTAL MBYTES READ WRITE. Total number of megabytes read or 
written during the report period. 


DENSITY. The tape density, from the mode byte in the OBR record. 
HDR SER. The serial number of the creating drive, from the tape header. 


Number of drives (hardware) and volumes appearing on this report, in compar- 
ison to the total number of drives and volumes. 


The model and serial number(s) of the CPU(s) designated in the report by 
letter. XA following the model number indicates that the processor was running 
in 370-XA mode. 


J 


TAPE PERMANENT ERROR SUNMARY 


c 
CHP DEVND P 
“1D ¢CLUA U DYE TIME VOLID 


wee HARCHARE wien 


OS O571 A 340 161934 73373 R 
CS 0372 aA 340 161951 73373 R 
OS 0574 A 340 161821 771972 R 
03 0574 A 340 163123 FIESUL 
CS 0574 A 340 171229 


Tape Subsystem Summaries 


aes DAT 


a 341 82 
RIOD FRAM 340 8&2 
TO 340 82 
O 
Lo .s SENSE... 
ED scsi:se-95- 1 l 2 HOR 
CHD FLO CNT cclid2-63 0 4 8 2 6 0 EXPLANATION —_ SER 
02 00000050 O£400080 OBCz000e COdB2D00 00020000 COZDCEZ1 OCOL7OND OOLADOOR START RD CHECK 08460 
02 CODCOOSO OEL000T0 OfCZ00CE CONZZD00 CCCECO0O OOSECE21 OCOL70D9 OO1A0002 START RD CHICK 08160 
02 24001008 C£00L008 CBCeC000 00483000 00039000 CozNCeZ1 OSOLTOCA OOLAOOLE START RD CHECK 08453 
OC OOOOACSS OEZOLOOS C2120000 00403790 O0C20000 OOzcsz21 OS9170NT OOLAOOCO \ia7D Clr ZE70 ©8483 
37 00060030 E6E69C001 05410000 00407D00 O00SC000 COcnsZ21 OS9L75EF 001A00160 MOY CAPABLE 0c453 


wuuN VOLUME OR CREATING DRIVE wuwe 


05 0570 A 340 115423 173579 R 
03 0571 A 340 115708 17357) R 


O02 44001008 CESOOALD OBC2FFES 00443000 00380000 CO2DC220 FIGLTOBE OOLA000S PARTIAL RECORD 0 
02 $4001008 O£400A1L9 OCCZ2FFAS 00442000 00330000 OOErc22l CCOLTZOFS OO1LA0004 PARTIAL RECCID 0 


NATE: TO CCNVERT "HDR SER® TO "CUA® USE ‘TAPE UNIT SER® IN ‘TAPE TEMPCRARY ERROV SLIISARY' (NEXT REPORT). 


CPU MODEL SERTAL NUMIER 
A JOBIXA o2coss 


Figure 2-18. Tape Permanent Error Summary 


Tape Permanent Error Summary 


This report describes in more detail the permanent errors that appear on the Tape 
Subsystem Exception report. The errors are grouped under hardware or 
volume/creating drive, and listed by CUA or VOLID (volume serial number) in 
the order they occurred. 


Notes: 

1. CHPID. The channel path ID from the permanent OBR record. 

2. RWE. These letters indicate which kind of permanent error is involved: 
READ, WRITE, or EQUIPMENT CHECK. 

3. CMD. The command code from the CCW in the OBR record. 

4. KFLG. The flag byte from the CCW in the OBR record. 

5. CNT. The byte count from the CCW in the OBR record. 

6. SCSW64-95/CSW32-63. Bits 64-95 of the SCSW, or bits 32-63 of the CSW, 
in the OBR record. 

7. SENSE. The sense bytes from the OBR record. 

8. HDR SER. The serial number of the creating drive. 
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TAPE TEMPORARY ERROR SUMMARY 


Ho 1 i 3 | 4 5 
TAPE C WRITE 
DEVNO UNIT P DEN- TOTAL TOTAL STATISTICS 
/CUA SER U SITY I/O CNT MOUNT MB/ERR(CT) ERSGAP 
0570 N/A A 6250 99938 20 -- ( 0) 
0570 N/A A OTHR 2 2 -- ( 0) 
0571 88460 A 6250 332788 42 249( 4) 
0571 88460 A 1600 94562 7 35( 8) 
0571 88460 A OTHR 1 1 -- ( 0) 
6250BPI TOTALS: 432726 62 ( 4) 
1600BPI TOTALS: 94562 7 ( 8) 
OTHRBPI TOTALS: 3 3 ( 0) 
TOTALS: 527291 72 ( 12) 
AVERAGE MEGABYTES/TEMPORARY READ ERROR 


AVERAGE MEGABYTES/TEMPORARY 
AVERAGE MEGABYTES/PERMANENT 
AVERAGE MEGABYTES/PERMANENT 
AVERAGE MEGABYTES/PERMANENT 
TOTAL MEGABYTES PROCESSED 
SERIAL NUMBER 


CPU 


MODEL 
A 3081XA 


020098 


WRITE ERROR 


READ ERROR 


WRITE ERROR 


ERROR 


Figure 2-19. Tape Temporary Error Summary 


Tape Temporary Error Summary 
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This report presents all the temporary read/write errors recorded for tape hard- 


REPORT DATE 341 82 
PERIOD FROM 340 82 


TO 


READ 
STATISTICS 


aaah | 0) 

== <i 0) 

==. 0) 

a oC 0) 

= 0) 

( 0) 

( 0) 

( 0) 

( 0) 
178 
116 

513 
919 
10107 


18 
0 


132 
92 


150 
92 


242 


340 82 


J 


ENV MTE SRC EDC VEL SKEW R/W WTM PAR/ OVER IBG 
MB/ERR(CT) CLNACT VRC LRC /PC CRC CHG 


1 
0 


12 


0 
0 


OV 


0 
0 


co) 


0 
0 


oe) 


0 
0 


oO 


ERR VRC CHK TACH 


0 
0 


& 


ware during the report period. The LIMIT control values specified when 


invoking EREP are ignored for this report. 


Notes: 


TAPE UNIT SER. The serial number of the tape unit. If this information is 
not available because the CUA did not have a permanent error, N/A appears in 
this field. 


TOTAL MOUNT. The number of volume mounts for this device at this 
density. 


0 
0 


oO 


DEVNO/CUA and DENSITY. The errors are listed by CUA or device number 
and density. 


TOTAL I/O CNT. The number of STARTIOs issued against this device at this 
density. 


RUN DET 
0 0 
0 0 
0 0 
0 2 
0 0 
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WRITE STATISTICS. The actual number of megabytes written per temporary 
write error, and the actual number of temporary write errors, by this device at 
this density. The number of erase gaps on this device at this density are totalled 
under ERSGAP. 


READ STATISTICS. The actual number of megabytes read per temporary 
read error, and the actual number of temporary read errors, by this device at 
this density. The number of cleaner actions on this device at this density are 
listed under CLNACT. 


These columns contain counts from the statistical data recorders, as follows: 


ENV VRC total envelope/vrc count 

MTE LRC total mte/Irc count 

SRC/PC for 3420, the total start read check count; for 3410, the total 
parity compare count 

EDC CRC total edc/crc count 

VEL CHG total velocity change count 

SKEW ERR total skew error count 

R/W VRC total rw/vrc count 

WTN CHK total write tape mark check count 

PAR/TACH for 3420, total partial record count; for 3410, total tach check 
count 

OVER RUN total overrun count 

IBG DET total ibg detected count 


Totals of STARTIOs, mounts, write and read statistics for each tape density. 


Averages and totals for megabytes of data processed during the report period. 
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2-20. 


Figure 
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Tape DEVNO/CUA Statistics Summary 


One of these reports is generated for each device (device number or CUA) that 
appears as a hardware exception on the Tape Subsystem Exception report. The 
report presents the DEVNO/CUA’s temporary errors that failed the limits set in 
LIMIT control statements. The errors appear by volume serial number in the 
order (date and time) in which they occurred. 


Notes: 


a 


CURRENT LIMITS. Because the report deals with temporary errors, the 
current LIMIT values for hardware appear for comparison. The LIMIT control 
statement is invalid for 9347 devices. 


DTE. The date and time are from the OBR record. 


R WEVU. This column contains the permanent errors against this volume. R 
indicates read errors, W indicates write errors, E indicates equipment checks, 
and U indicates unknown. 


MB/ERR TEMP. The actual error count and error frequency for this volume 
mount. 


I/O CNT. The number (from the OBR record) of START I/O instructions 
issued against this CUA while this volume was mounted. 


These columns contain counts from the statistical data recorders, as follows: 


ENV VRC total envelope/vrc count 

MTE LRC total mte/Irc count 

POST AMBL post-amble count 

C/P COMP c/p compare count 

CRC III crc ili count 

WRTG VRC write trigger vrc count 

SLOW — BEG — END slow begin and end counts 

CHAN BUFF channel buffer count 

ERLY BRBC early begin read back check count 

PART REC partial record count 

TIE track in error parity bit (P) and byte (07) 

CPU as identified by EREP 

CHPID channel path ID from the permanent error OBR 
record 


DENSITY. From the mode byte in the OBR record. 
HDR SER. The serial number of the creating drive, from the tape header. 


Totals and averages of the data presented in the report. 
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TAPE VOLUME STATISTICS SUMMARY 


REPORT DATE 341 82 


PERIOD FROM 340 82 
TO 340 82 


VOLUMES EQUAL TO OR BELOW LIMITS OR PERMANENT ERRORS 


~---------------------- 3420 
1600 BPI 
TEMP WRT(CT) TEMP RD(CT) TEMP 
CURRENT LIMITS 4 (15) 26 ( 2) 
MBYTES/ERR (CT) VOLUME 4 (15) 26 ( 2) 
R 
VOLUME CHP DEVNO W ---MB/ERR PERM--- --- MB/ERR 
SERIAL DTE HH:MM:SS -ID /CUA E READ(CT) WRITE(CT) WRITE(CT) 
F36BJL 340 14:36:56 0571 -- ( 0) -- ¢ 0) -- ( 0) 
F36BJL 340 16:34:28 O05 0574 --( 0) --( 0) -- ( 0) 
NONSHR 340 10:03:58 580 E-- ( 0) -- ( 0) -- ( O) 
NONSHR 340 10:17:50 580 -- ( 0) -- ( 0) -- ( 0) 
NONXA 340 11:03:58 580 E -- ( 0) -- ( 0) -- ¢ 0) 
NONXA 340 11:17:50 580 == ( OJ). == ¢ 0). QO) 
COLUMN TOTALS: ( 0) ( 0) (2) 
TOTALS : MOUNTS = 4 
TOTALS: MEGABYTES PROCESSED = s41 


CPU MODEL SERIAL NUMBER 
A 3081XA 020098 
B 3081 020098 


Figure 2-21. Tape Volume Statistics Summary 


Tape Volume Statistics Summary 


6250 BPI 
WRT(CT) TEMP RD(CT) 
4 (15) 26 ( 2) 
4 (15) 26 ( 2) 
TEMP--- CLNR ERASE 
READ(CT) ACTS GAPS 
-- ( QO) 19 0 
-- ( 0) 9 0 
es C 20) 0 0 
s= (0) 0 1 
-- ( QO) 0 0 
SS 00 0) 0 ae 
( 0) 28 2 


I/O 
CNT 


4285 


4082 


1136 


1136 


10643 


BLK 
LNG 


18B4 
OFEC 


18B4 
18B4 


18B4 
18B4 


ae== 3010 SSS-s<+-e5 
1600 BPI 
WRT(CT) TEMP RD(CT) 
4 (15) 26 ( 2) 
4 (15) 26 ( 2) 
C 
--JOB--- P DEN- HDR 
--NAME-- U SITY SER 
F36BJL1T A 6250 08460 
F36BJL1K A 6250 08453 
TESTTEST B 6250 00000 
TESTSEST B 6250 08460 
TESXA B 6250 00000 
TESXA B 6250 08460 


This report shows all the activity for every volume listed as an exception on the 
Tape Subsystem Exception report. Entries are grouped by volume serial and 


listed in chronological order. 


Notes: 


I, CURRENT LIMITS. Because the report includes temporary errors, the current 
LIMIT values for volumes appear for comparison. 


2. VOLUME SERIAL. There is no volume serial number if the tape is unlabelled 


or cannot be read. 


3. CHPID. The channel path ID from the permanent error OBR record. 


4. RWEVU. This column contains the permanent errors recorded against this 
volume. R indicates read errors, W indicates write errors, and E indicates 
equipment checks, and U indicates unknown. 


J 


J 
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Tape Subsystem Summaries 


MB/ERR PERM. The error count and frequency for permanent read and write 
errors. 


MB/ERR TEMP. The error count and frequency for temporary read and write 
errors. 


Except for the CPU indicator, these columns contain information taken from 
the OBR record: 


CLNR ACTS cleaner action count 

ERASE GAPS erase gap count 

I/O CNT START 1/O instruction count 

BLK LNG block length from the OBR record; or the average block length 
JOB NAME the jobname 

CPU as identified by EREP 

DENSITY tape density, from the mode byte from the OBR record 


HDR SER. The serial number of the creating drive. 


Totals for the volumes on this report. 
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Threshold Summary Report 


Threshold Summary Report 
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If you decide not to use the System Exception report series, you can get much of 
the same information for your supported tape drives using the tape Threshold 
Summary report. In fact, for some tape device types, you will have to use the 
Threshold Summary, because they are not included in the System Exception 
series. See Chapter 17, “Magnetic Tape Drives” on page 17-1 for the device 
types supported for the System Exception and Threshold Summary reports. 


Useful parameters for customizing your Threshold Summary report are: 


CUA 
DATE 
DEV 
DEVSER 
MODE 
TIME 
VOLID 


Care should be taken when specifying report parameters other than these as 
report results could be misleading. See Figure 12-1 on page 12-2 in Part 3 for 
any restrictions on using the parameters in combination. 


The Threshold Summary uses OBR (34XX) and MDR (8809) records to show all 
the permanent read/write errors, temporary read/write errors, and media statistics 
for each volume mounted. The data is grouped within each tape subsystem, 
which consists of a control unit and its drives. 


The report has four sections, the first three of which appear once for each 
processor in your installation. The first section, DEV(Gce) STATISTICS, shows 
one line of statistical and error data for every demount record whose error count 
exceeds the read or write threshold you coded on the report parameter. 


The second section, PERMANENT ERROR SUMMARY, shows a one-line entry 
for each permanent error. A permanent error can be a read error, a write error, 
or an equipment check. 


The third section, TEMPORARY ERROR SUMMARY, is a summary of all tem- 
porary errors recorded for each device number/CUA, whether they exceeded your 
threshold or not. 


The fourth section, VOLUME STATISTICS, takes each MDR and OBR record 
from the first three sections of the report, and shows the errors and usage statis- 
tics by volume serial number rather than device number/CUA. Note that the 
columns in this part of the report are titled differently depending on the device 
type involved. See the report considerations under “34XX Tape Devices” in 
Part 4 for how they differ. 


Threshold Summary Report 


Figure 2-22 on page 2-60, Parts 1 and 2, shows the Threshold Summary report 
for tape devices. Following is the MVS JCL used to generate the report. 


//THRESHLD EXEC PGM=IFCEREP1,PARM=(THRESHOLD=(001,001)', 
// 'DATE=(82117)','ACC=N' ,HIST) 

//TOURIST DD  SYSOUT=R 

//EREPPT DD  SYSOUT=R 

//DIRECTWK DD UNIT=SYSDA,SPACE=(CYL,5,,CONTIG) 

//ACCIN DD DSN=EREP.DAYLY.HISTORY,DISP=OLD 

//SYSIN DD * 

[SHARE statements for appropriate I/O devices] 


j* 


For more detailed information about the various parts of the report, see the mainte- 
nance documentation for the product involved. 
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A 3 | XXX 34K, 580378809 SUBSYSTEM SUMMARY 100% 
Bory STATISTICS - DEVS EQUAL TO OR EXCEEDING 001 TEMP RDS OR 001 TEMP WRTS 


TU DATE VOLUME TIME --TEMP-- 10 DEN- NRZI_ R/WWR TG LRC CRC ECC SKEW ERLY VEL <----CPU---- HDR 
DEV SERIAL DAY YR SERIAL HH MM S$S.TH RDS WRITS COUNT SITY NOISE VRC VRC MTE EDC ENV ERR BOR CHG ID SERIAL SER 
570 N/A 102 82 72770 09 29 28.21 0 147 1120 N/A NA 0 0 0 0 0 0 0 0 3081 020015 8455 
$70 N/A 102 82 72770 09 29 32.13 0 2 9 N/A NA 0 0 2 0 0 0 0 0 3081 020015 8433 
571 N/A 102 82 ZBBI2F 11 20 56.13 0 1 1239 N/A NZA 0 0 0 1 0 0 0 3081 020015 8460 
570 N/A 103 82 169842 10 01 30.68 0 1 27, NA NAA 0 0 0 0 0 0 0 0 3081 020015 84353 
PE SEEESESEEE>EDEDESESESEPEP>PPPP>PEPEP>PEPPPIDIPEPIPIPEPIPIPIPIPPIPISIPEEPPEPPEEESESEEE Ee Esser ets stetssssddesedtds$99999999599999) 


PERMANENT ERROR SUMMARY 


PW PERMANENT WRITE PR PERMANENT READ PF CAUSE UNKNOWN 
EC EQUIPMENT CHECK, CAUSE UNKNOWN EE ERASE HEAD EB TAPE BOTTOM, LEFT OR RIGHT 
EL LOAD FAILURE EP AIR BEARING PRESSURE ET TACH START FAILUR 
EV VELOCITY CHECK ER RESET KEY WC WRITE CURRENT CHECK 
EM MODE SET 
... SENSE BYTES.... 
121212 22 212 2 2 2 2 
DEV SERIAL ERR VOLID LAST CCW STATUS 012345 67892012+8388 678981 238 
CC CA FL CT US C$ CT 
*570 88433 PW 72770 01 COE608 64 7FF& OE 00 0000 08 44 E6 D8 00 40 3D 00 00 98 00 00 00 2D C2 20 F1 91 70 E6 00 1A 00 09 
#571 88460 EM D3 000000 00 0000 06 00 0001 00 22 00 02 00 40 3D 00 00 08 00 00 00 2D C2 21 0C 91 70 E6 00 00 00 00 
*576 76242 PR 02 185BF8 00 0050 OE 40 0034 08 C2 FF AS 00 44 3D 00 00 88 00 00 00 2D C2 18 62 91 60 A7 00 1A 00 08 
"570 88433 PW 169842 01 898000 60 OFD9 OE 00 0000 08 44 00 40 00 40 3D 00 00 08 00 00 00 2D C2 20 Fl 91 70 E6 00 1A 00 09 
*571 88460 EM 172337 D3 000000 00 0000 06 00 0001 00 22 00.06 00 40 2D 00 00 08 00 00 00 2D C2 21 0C 91 70 E7 00 01 00 00 
*571 88460 EM 172337 D3 000000 00 0000 06 00 0001 00 22 00 06 00 40 2D 00 00 08 00 00 00 2D C2 21 0C 91 70 E7 00 00 00 00 
¥576 76242 EM 177659 D3 000000 00 0000 06 00 0001 00 22 00 06 00 40 2D 00 00 08 00 00 00 2D C2 18 62 91 60 C3 00 15 00 00 
XXXXXAXKNNANN AKAN KNX NHN HNN NHN HLH HHH NHN HHH HHI HH HHH HHH HHH HH HH HH HN HHH HH HHH HH HHH HNN HN HHL NH HEN NEN AHN NHN HH NHN HN HHH AHN H HK 
34XX/3803/8809 SUBSYSTEM TEMPORARY ERROR SUMMARY 

ERRORS/ 100K READ WRITE ECC 

108 DATE TOTAL TOTAL STATISTICS STATISTICS VRC STRD PART OVER VEL IBG 
DEV READ WRITE -FROM---TO-- I0$ MOUNTS. ERRORS CLNRAC . ERRORS ERSGAP . ENV CHK RECK RUN CHG DET 
570 0.00 100 10282 10382 20077 8 0 4. 150 251. 0 0 0 0 0 0 
571 0.00 8.16 10282 10382 12254 8. 0 0. 1 1. 1 0 0 0 0 0 
572 0.00 0.00 10382 10382 1237 1. 0 0. 0 0. 0 0 0 0 0 0 
575. 0.00 0.00 09882 10382 58118 16. 0 0 0 0. 0 0 0 0 0 0 
577 0.00 0.00 10382 10382 1455 2 0 0. 0 0. 0 0 0 0 0 0 
TOTAL 0.00 1004 93141 35 0 151 

EB xxx. 34XX/3803/8809 SUBSYSTEM SUMMARY XXXXX 
XXXXX PRIMARY DEV 0570-05 XXXXX 
DEV STATISTICS - DEVS EQUAL TO OR EXCEEDING 001 TEMP RDS OR 001 TEMP WRTS 

TU DATE VOLUME TIME --TEMP=-  I0 DEN~ NRZI_R“W WR TG LRC CRC ECC SKEW ERLY VEL ----CPU---- HDR 
DEV SERIAL DAY YR SERIAL HH MM SS.TH RDS WRTS COUNT SITY NOISE VRC VRC MTE EDC ENV ERR BOR CHG ID SERIAL SER 
570 N/A 117 82 174262 06 04 30.02 0 1 S533 NVA NCA 0 o oO oo 12 1 0 0 $033 020862 1433 


XXXXXXXXXAXXNAX XN NK NNN HNN H NH NH HHH HH HHH NH HINA H IH HHI HH HHH HHH HAHN HN HH INAH NN HLH HLH NH HH HLH HHH HNN NINH HIN HHL NH HH IO HH NH HEH HHH HIN HHH HH HN HHI NHN HI 
PERMANENT ERROR SUMMARY 


PW PERMANENT WRITE PR PERMANENT READ PF CAUSE UNKNOWN 

EC EQUIPMENT CHECK, CAUSE UNKNOWN EE ERASE HEAD EB TAPE BOTTOM, LEFT OR RIGHT 

EL LOAD FAILURE EP AIR BEARING PRESSURE ET TACH START PAILURE 

EV VELOCITY CHECK ER RESET KEY WC WRITE CURRENT CHECK 

EM MODE SET 

» SENSE BYTES.... 
11221 2 2 212 212 «2 «2 2 22 «2 
DEV SERIAL ERR VOLID LAST CCW STATUS 12383 45 678 8 8612853 4 5 6 7? 8 Y 8 1 2 8 
cc CA FL CT Us CS CT 


576 87930 EB 174733 02 860BF8 20 0050 OE 00 0050 50 20 00 04 62 40 2D 20 00 08 00 00 00 6B 95 1E FA 01 70 74 OF 18 00 10 
XKXXX NK NKNNNX NK NHN HNN K NK NHN K NHN HNN KKH NHN HN HNN HNN HHH HNN HNN HHH NNN HNN HN HNN HHI HH HHH HN HHH HH HH HHH HHH HHH HHH INH HHH II 


34XX7380378809 SUBSYSTEM TEMPORARY ERROR SUMMARY 
ERRORS/100K READ WRITE EC 


10s DATE TOTAL TOTAL STATISTICS STATISTICS. VRC =STRD ore OVER VEL IBG 
DEV READ WRITE -FROM---TO-- Tos MOUNTS. ERRORS CLNRAC . ERRORS ERSGAP . ENV CHK REC RUN CHG DET 
570 0.00 15.68 11782 11782 6374 3. 0 0. 1 i. i 0 0 0 0 0 
571 0.00 0.00 11782 11782 784 1. 0 Qo. 0 Oo. 0 0 0 0 
574 0.00 0.00 11782 11782 784 1. 0 0. 0 0. 0 0 0 0 0 0 
577 0.00 0.00 11782 11782 418 1 0 Oo. 0 0. 0 0 0 0 0 0 
TOTAL 0.00 11.96 8360 6 0 1 


Figure 2-22 (Part 1 of 2). Threshold Summary Report for Tape 
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2-60 EREP User’s Guide 


Threshold Summary Report 





EE XXXXX 34XX/3803/8809 SUBSYSTEM SUMMARY XXXXX 
XXXXX PRIMARY DEV 0570-057F XXXXX 
NO DEVS EXCEEDED THRESHOLD: 82117 TO 82117 
MM KKK K KAKA MHI NNN MIN KN HHH HHH HHH NHI NHN NH NH MH HHH HNN NN HHH NNN IHN RANA NA HAKAN AK ANAK AAA AAA RXR AANA AKAN AANA AAA ANA AAA NAAN 
PERMANENT ERROR SUMMARY 
NO PERMANENT ERRORS ENCOUNTERED: 82117 TO 82117 
MMOH HK HHH HAHN HHH HHH HHH HMMM HH HMA HH HHH HN NNN NHK HHH NMA NAAN ANNA NAA A AAA RA AANA AA KX AAAK KANN NK KK KA KAM MAKKAH AKAMA AAA NAAN 


34XX7 3803/8809 SUBSYSTEM TEMPORARY ERROR SUMMARY 
READ WRITE ECC 


ERRORS 100K 
Ios DATE TOTAL TOTAL STATISTICS STATISTICS VRC STRD PART OVER VEL IBG 

DEV READ WRITE -FROM---TO-- 10s MOUNTS. ERRORS CLNRAC . ERRORS ERSGAP . ENV CHK RECK RUN CHG DET 
570 0.00 0.00 11782 11782 2359 2. 0 0 0 0 0 6 0 ] ] t 
571 0.00 0.00 11782 11782 132 1. 0 0 0 0 0 e 0 6 6 6 
576 0.00 0.00 11782 11782 2553 3. 0 6 6 0 1 1 0 0 0 6 
577 0.00 0.00 11782 11782 784 1. 0 0 0 0 0 0 0 6 ) e 
TOTAL 0.06 0.00 5828 7 0 0 


VOLUME STATISTICS - VOLUMES EQUAL TO OR EXCEEDING 001 TEMPORARY READS OR 001 TEMPORARY WRITES OR EERE? ERRORS 


VOLUME DATE TIM TU RD/ “PERM-- --TEMP-- RD RTRY/ ERASE IQ COUNT BLOCK PROGRAM -~--CPU---- MOD DEN- HDR 
SERIAL DAY YR HH Ms $s TH DEV SERIAL WRT RDS WRTS RDS WRTS CLNR ACT GAPS RDS WRTS LENGTH ID ID SERIAL @ SITY SER 

102 82 09 29 28.59 571 88460 R 0 0 0 0 0 0 0 6 3081 62808015 8 6258 e 

102 82 14 42 10.91 576 76242 R 1 0 0 0 18 0 2 0 H44DERIB 3081 620015 8 6258 6 
769842 103 82 10 O01 21.27 570 88433 W 0 1 0 1 0 26 27 1 3081 6208015 8 6258 8433 
T69842 103 82 10 01 30.68 570 10000 0 1 0 1 0 26 27 0 N/A 3081 6286015 1 806 8433 
T72337 103 82 10 55 54.46 571 88460 R 0 0 0 0 0 0 1 0 XAWEEKI2 3081 6208015 8 16808 8433 
T72337 103 82 10 56 33.24 571 884960 R 0 0 0 0 0 0 1 @ XAWEEK12 3081 6280015 8 1600 8433 
T74262 117 82 06 04 30.01 570 10000 0 0 0 Jl 0 1 5513 © REM74262 3033 628862 1 see 1433 
174733 117 82 10 16 17.22 576 87930 E 0 0 0 0 4 0 16 21412 RMFWK17 3033 820862 8 1666 7936 
177659 103 82 11 12 07.94 576 76242 R 0 0 0 0 0 0 0 © D33SMYIA 3081 6288015 8 1606 8 
ZBBIZ2F 102 82 11 20 56.13 571 10000 0 0 0 1 0 l 1239 @ DISBLDIW 3081 620015 1 806 8466 
72770 102 82 09 27 28.15 570 88433 W 0 i Oo 147 0 204 1120 2995 DPD&SSTL 3681 620015 8 6258 8433 
72770 «102 82 09 29 28.21 570 10000 0 | 0 147 0 204 1120 @ N/A 3081 6200615 1 800 8433 
72770 «102 82 09 29 32.13 570 10000 0 0 0 2 0 21 9 © DPDS3STL 3081 62808015 1 sea 8433 


Figure 2-22 (Part 2 of 2). Threshold Summary Report for Tape 
Notes: 
1. DEV is the device number; same as the CUA. 
2. An asterisk (*) before a device number indicates a 370-XA mode record. 


3. The first three parts of this report are produced for each processor (CPU) 
involved. 


4. The volume statistics summarize all the permanent errors presented in the pre- 
ceding parts of the report. 


 ————$——————LL LL LL TET ET PR 
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Detail (PRINT) Reports 


Detail Edit and Summary (PRINT) Reports 


Limiting PRINT Output 
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The PRINT report parameter gives you reports that allow you to look at the 
error records themselves, on two levels. 


e Detail Edits format every record you have selected on a separate page, 
including a hexadecimal dump of the record itself. 


e Detail Summaries summarize selected data from the record and total the 
number of records that met your selection criteria; some Detail Summaries 
show only the total number of selected records. EREP produces one Detail 
Summary per CPU (processor) for each record type selected. 


The format and content of the Detail Edits and Summaries vary according to the 
type of record and the device or product involved. See the report examples that 
follow, and Figure 12-2 on page 12-4, for the record types and the devices associ- 
ated with them. 


Chapter 10, “Error Records for EREP” has more information about the records 
covered by each of these examples; look under the type of record indicated in the 
report header. 


For some devices, the PRINT parameter produces Data Reduction reports that 
format and summarize environmental data gathered by the device itself. These 
reports are entirely device-specific and are meant to help the IBM Customer Engi- 
neer solve problems that are causing random/intermittent errors. Figure 2-26 on 
page 2-67 is an example of a Data Reduction report. 


The PRINT parameter allows you to request more than one kind of Detail 
PRINT report at a time; it is the only report parameter that works this way. See 
the description of the PRINT report parameter in Part 3. 


An EREP run in which you requested PRINT reports without also being very 
selective of the records to be processed could generate a great deal of printed 
output. For example, when you code PRINT =PT without also using the date, 
time and type selection parameters, EREP produces a Detail Edit of every avail- 
able record, regardless of type or when they were created. Coding PRINT =PS 
alone produces those same Detail Edits, plus Detail Summaries of every type of 
record EREP found in the input file. 


If you do not want to see detailed reports for every error record on your ERDS 
or history data set, you must limit the PRINT reports by using the selection 
parameters. You can use PRINT reports to see, for example, summary informa- 
tion about a particular class of devices on a particular control unit; or detail 
information from a particular type of record as associated with a particular device 
number. 


Every selection parameter except DEVSER is valid for use with the PRINT report 
parameter. 


3 


C 


Examples 


Detail (PRINT) Reports 


Figure 2-23 through Figure 2-52 are examples of Detail Edit and Summary 
reports for various kinds of error and operational records. Although it is unlikely 
that you would request all of these reports at once, it is possible to do so. In this 
case, the MVS JCL would look like this: 


//DETAIL EXEC PGM=IFCEREP1,PARM='PRINT=AL,ACC=N,HIST' 
//TOURIST DD  SYSOUT=R 

//EREPPT DD  SYSOUT=R : 

//DIRECTWK DD UNIT=SYSDA,SPACE=(CYL,5,,CONTIG) 
//ACCIN DD DSN=EREP . DAYLY.HISTORY , DISP=OLD 

//SYSIN DD * 

[SHARE statements for appropriate I/O devices] 


j/* 


The output would include many Detail Edit reports for each record type. More 
realistic examples of the code needed to produce the various Detail PRINT 
reports are in the sample EREP runs in Chapter 4, “Running EREP.” 


Not all the possible PRINT report combinations for each record type are shown in 


the following examples; the maintenance documentation for a particular device 
Should include sample Detail Edit reports for the relevant records. 
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CCH Detail (PRINT) Reports 





MODEL 9373 SERIAL NO. 034762 
VS 2 REL. 02 
---~ RECORD SOURCE - CCH TYPE - INBOARD 
JOB NAME TESTCCH 
DAY YEAR HH MM SS.TH 
DATE - 264 86 TIME - 07 19 53 73 


CHANNEL/UNIT ADDRESS 000700 


cc DA FL cr 
FAILING CCW 00 000000 00 00 0000 


K CA US CS CT 
CSW 00 000000 00 04 0000 

---UNIT STATUS--- ---CHANNEL STATUS--- 
ATTENTION 0 PRGM-CTLD IRPT 0 
STATUS MODIFIER 0 INCORRECT LENGTH 0 
CONTROL UNIT END 0 PROGRAM CHECK 0 
BUSY 0 PROTECTION CHECK 0 
CHANNEL END 0 CHAN DATA CHECK 0 
DEVICE END 0 CHAN CTRL CHECK 1 
UNIT CHECK 0 I/F CTRL CHECK 0 
UNIT EXCEPTION 0 CHAINING CHECK 0 


kkkkkkkkkkkkkkkkkkkkkkkhkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkekkkkkkkkhkkkkkkkkkkekkkkkkkkkhkakkkkkkk 


---LIMITED CHANNEL LOGOUT DATA EDITING--- 
---FIELD VALIDITY FLAGS--- ---TERMINATION CODE--- 


SEQUENCE CODE STORED IS VALID 0 INTERFACE DISCONNECT @) 
UNIT STATUS STORED IS VALID 0 STOP, STACK OR NORMAL 0 
CCW ADDR AND KEY IN CSW ARE VALID 0 SELECTIVE RESET 0 
CHANNEL ADDRESS STORED IS VALID 0 INTERFACE INOPERATIVE 0 
DEVICE ADDRESS STORED IS VALID © ERROR ALERT ) 
---SEQUENCE CODE--- 

ERROR DETECTED DURING TEST I/O OR CLEAR I/O 1 

COMMAND WENT OUT, DEVICE STATUS NOT IN 0 

COMMAND ACCEPTED, NO DATA TRANSFERRED 0) 

AT LEAST ONE DATA BYTE TRANSFERRED ) 

COMMAND EITHER NOT SENT OR NOT ACCEPTED 0) 

COMMAND ACCEPTED BUT DATA XFER UNPREDICTABLE 0 

---MEASUREMENT BYTE--- 

BYTE: 00000000 NUMBER OF PENDING OPERATIONS (NPO): 000 


---DELAY CODE--- 
CHANNEL BUSY 0 
CONTROL UNIT BUSY 0 
DEVICE BUSY 0 


Figure 2-23 (Part 1 of 2). CCH Detail Edit Report 
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CCH Detail (PRINT) Reports 


I/O UNIT FOUND BUSY 
CHANNEL/UNIT ADDR 0740 0741 0742 0746 


--- CHANNEL TYPE --- 
INTGTD MPX 


REE KEKKEERKEERUKEEERKEEEEEKREEEREEKEREKEREKEKEERKKKKEKKKEKKKKKKKKKKKKKKKKKKKKKKK 


CHANNEL ERROR ANALYSIS 
CSW STORED BY INTERRUPT 
TERMINATION BY -- SYSTEM RESET- CODE 3 
TIME CHANNEL DETECTED ERROR - COULD NOT BE ASSESSED 
VALIDITY OF RECORDED DATA 


COUNT = NOT VALID 
SENSE DATA = STORED 
UNIT STATUS = NOT VALID 
COMMAND ADDRESS = NOT VALID 
CHANNEL ADDRESS = VALID 
DEVICE ADDRESS = NOT VALID 


PROBABLE SOURCE OF ERROR- CHANNEL 
HRI IK IIE IKI KIKI KEIR IRI KEKE IKE IKI KIKI KEKE IRE EERE KE REREKEKEKEKEKKKEK 


HEX DUMP OF RECORD 
HEADER 20660800 00000000 O0086264F 07195373 00234567 93730000 


0000 E3C5E2E3 C3C3C800 07400741 07420746 00000000 00000000 00000000 00000000 
0020 00000000 00040000 444002C0 00000000 01000700 00000000 40000700 0004EC94 


Figure 2-23 (Part 2 of 2). CCH Detail Edit Report 


MODEL 9373 CHANNEL CHECK RECORDS 


DAY YEAR DAY YEAR 
DATE RANGE - FROM 264 86 TO 268 86 


SERIAL NO. 234567 
NO.OF RECORDS 00005 
--- SUMMARY OF MODEL 9373 CHANNEL CHECK RECORDS --- 


ERROR SOURCE 


CPU 0000 

CHAN 0005 

SCU 0000 

SU 0000 

CU 0000 

--- UNIT STATUS --- --- CHANNEL STATUS --- 

ATTENTION 0000 CHANNEL END 0000 PRGM-CTLD IRPT 0000 CHAN DATA CHECK 0000 
STATUS MODIFIER 0000 DEVICE END 0000 INCORRECT LENGTH 0000 CHAN CTL CHECK 0005 
CONTROL UNIT END 0000 UNIT CHECK 0000 PROGRAM CHECK 0000 I/F CTL CHECK 0000 
BUSY 0000 UNIT EXCEPTION 0000 PROTECTION CHECK 0000 CHAINING CHECK 0000 


Figure 2-24. CCH Detail Summary Report 


Chapter 2. EREP Reports 2-65 


CRW Detail (PRINT) Reports 





DEVICE NUMBER: 0480 REPORT: CRW EDIT DAY YEAR RECORDING MODULE: CRWEXMPL 
DATE: 169 81 C3D9E6C5E7D4D7D3 ) 
DEVICE TYPE: N/A SCP: VS 2 REL. 3 
CPU MODEL: 3081 HH MM SS.TH 

CHANNEL PATH ID: 02 CPU SERIAL: 020024 TIME: 12 28 41.54 
CHANNEL REPORT WORD INFORMATION 

CRW VALIDITY: VALID, OVERFLOW INDICATED 

CRW: F738 2214 

RECORDING CODE: 01 

ORIGIN: SYSTEM DAMAGE MACHINE CHECK 

STORED BY: HARDWARE 

CREATED BY: HARDWARE 

PROCESSOR ADDR: 0002 
CRW SEQUENCE NUMBER: 63519980 
ASSOCIATED CRW SEQUENCE NUMBER: 9A6F1187 


INTERRUPT SUBCLASS DEFINITION TABLE: 73981674 F1EA8716 
PATH MANAGEMENT CONTROL WORD 

SUBCHANNEL ENABLED 0 

PROG CHECK ADDR >= LIMIT 0 

PROG CHECKADDR <= LIMIT 1 

STORE MEASUREMENTS IN CMB 1 

STORE DCTI IN EXT STAT WORD 0 

DYNAM PATH MULTI-PATH STATE 1 

TIMING FACILITY AVAILABLE 0 

VALID DEVICE NUMBER ASSIGNED 0 


UCB INFORMATION CHANNEL PATH INFORMATION 
UCB LEVEL VALUE: F8 CHANNEL PATH RECOVERY COUNT: FO 2 | 
UCB LEVEL BIT MASK: 1673FOFO 
SUBCHANNEL RECOVERY ANCHOR: 62751387 
<== =< === 5 == === UCB DEVICE STATUS FLAGS--------------- ----CHPID ICHPT FLAGS----- 
UCB TEMPORARILY UNUSABLE 0 INTRCEPT CNDITION EXISTS 0 CHP VALID FOR INSTLATION 1 
DEVICE NOT READY 0 DVICE HAS NO USABLE PATH 0 CHP OWNED BY THIS SYSTEM 1 . 
DEVICE SUBCHAN UNUSABLE 0 DEVICE HAS NO SUBCHANNEL 1 CHP IS ONLINE 1 J 
PENDING SENSE OPERATION 1 ABNORMAL UCBLEVEL VALUE 1 CHP UNDRGOING CHP RCOVRY 1 
START SUBCHANNEL ISSUED 0 RESERVED 0 VARY OFF IN PROG FOR CHP 0 
HALT SUBCHANNEL ISSUED 0 RESERVED 1 FORCE CHP OFFLINE FAILED 0O 
CLEAR SUBCHANNEL ISSUED 1 RESERVED 0 RECOVRY IN LAST UCB SCAN 0 
DVICE OFFLN DUE TO ERROR 0 RESERVED 0 RESERVED 0 


HEX DUMP OF RECORD 

HEADER 25831000 00000000 O081169F 12284154 01020024 30810000 
0018 C3D9E6C5 E7D4D7D3 01800002 00020000 F7382214 O480FFOO 63519980 9A6F1187 
0038 12341234 FOFOOOF8 1673FOFO 62751387 FOFO7398 1674F1EA 8716 


Figure 2-25. CRW Detail Edit Report (370-XA only) 
Notes: 
1. These words appear if any CRW records are lost because they are being 
produced on the hardware queue faster than the recording service can retrieve 
them. 


2. All zeros indicates that the UCB was not available. 


3. The channel path table flags appear only if the CRW indicates a CHPID. 
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C 


yw 


RHEE KEKEKEKEKEKKEKEKEKEKEKEKKEKKEKKEKKKKKKKKE 


MAINTENANCE DEVICE CODE FOR DEVICE TY 


DEVICE ADDRESS = 0701 SHARED SERIAL 
Eq 
MD CODE TYPE = DC1 MDC=0008 SAMPLES= 1 
MD CODE TYPE = FC1 MDC=0200 SAMPLES= 1 
MD CODE TYPE = SV  MDC=0130 SAMPLES= 2 
MODIFER(S): (ff 
EXPECTED ACTUAL ACCESS EVEN 
DESTINATION DESTINATION DIRECTION TRACK 
CCC-HH-M/F-SM CCC-HH-M/F-SM F/R E/O 
7 0M O 015 F 3 R 0 
7 es mM 0 015 F 3 R 0 
MD CODE TYPE = SVE MDC=8130 SAMPLES= 1 
MODIFER(S) : 
EXPECTED ACTUAL ACCESS EVEN 
DESTINATION DESTINATION DIRECTION TRACK 
CCC-HH-M/F-SM CCC-HH-M/F-SM F/R E/O 
7 0M O 015 F 3 R 0 


MD CODE TYPE 
MD CODE TYPE 
MD CODE TYPE 
MD CODE TYPE 


sc MDC=0001 SAMPLES= 
SCE MDC=8001 SAMPLES= 
RW MDC=0132 SAMPLES= 
DC MDC=0300 SAMPLES= 


not 
FOR N 


ECC CORRECTABLE UNCORRECTABLE 
ALTERNATE DATA BLOCK N/A 

ccc = 999 HH = 2 BB = 2 

IFC1691 6 RECORDS NOT USED BY IFCNFPDR FOR 


Figure 2-26. Data Reduction Report 


Notes: 


Data Reduction Report 


HREEKEEKKKEKKEKKEKKKEEEEKEKKKKKEKEEKEKEK 


PE = 3370 
= 700006 


OVER/ DIFFERENCE CT 
UNDER REMAINDER 
OS/US DIFF 

OS- 7 @) 


OS- 7 ) 


DIFFERENCE CT 
UNDER REMAINDER 
OS/US DIFF 

Os- 7 ) 


OVER/ 


NO SYNC BYTE FOUND 
N/A 


THIS cux 070x [J 


1. There are six different MDCs, each using a particular subset of fault symptom 


codes. 


2. The number of records used to build this MDC. 


3. Four of the MDCs have additional information printed. 


4. An additional MDC is printed for records with only the environmental data bit 


on. 


5. To build the MDC, only selected OBR (by fault code) records from a 3370 are 


used. 
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DDR Detail (PRINT) Reports 


~~~ RECORD ENTRY TYPE - DDR SOURCE - DDR MODEL - 3033 


VS 2 REL. 03 


SERIAL NO. 025791 


DAY YEAR HH.MM.SS.TH JOB IDENTITY DUMMYDDR 


061 80 12 18 47 09 


FROM UCB DEVICE TYPE 00001008 
FROM CHANNEL UNIT ADDRESS 000234 
FROM VOLUME SERIAL NUMBER 234567 
FROM PHYSICAL ID O01 
RECORD DEPENDENT SWITCH 10 


RECONFIGURATION PERFORMED AS A RESULT OF A PERMANENT ERROR 


HEX DUMP OF RECORD 


C4E4D4D4E8C4C4D9 
TO UCB DEVICE TYPE 00001008 
TO CHANNEL UNIT ADDRESS 000236 
TO VOLUME SERIAL NUMBER 765432 
TO PHYSICAL ID 02 


HEADER 60830810 00001100 O080061F 12184709 00025791 303302A0 


0000 C4E4D4D4 E8C4C4D9 F2F3F4F5 F6F7F7F6 F5F4F3F2 01000234 00001008 02000236 


0020 00001008 


Figure 2-27. DDR Detail Edit Report 


Notes: 


1. For records created in 370-XA mode, the device number (DEV) replaces CUA. 


SUMMARY OF DDR RECORDS CUA 000234 


DAY YEAR DAY YEAR 
RECORD DATE RANGE 061 80 062 80 


MODEL - 3033 SERIAL NO ~ 025791 
TOTAL NUMBER OF RECORDS=0002 


Figure 2-28. DDR Detail Summary Report 
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MCH Detail (PRINT) Reports 





--- MACHINE CHECK DATA EDITING -~-- 
TT EC TCCOCCCLCCCISCESC COSCO CSCC SPSS TESS SO STEP eee eee ET SSPE CCC CeCe Pe Pe Ce TP CECE C EPP CLES eee SS 


MODEL=9373 SERIAL NO= 010620 
VS 2 REL. 03 
DAY YEAR HH MM SS 
DATE - 211 86 TIME - 16 40 51 
SM KS CM UA IA 
OLD MACHINE CHECK PSW 00 OC 00 0000 O1C90A 
JOB NAME= TEG 
PROGRAM NAME= RMSTEG 


‘eee EREREEREE EERE SEER ER ERE RE SE SESRE SESE RES ERE ERE ERS ERE RERERERE SESE SES ES ESE 


NOTE: THE PRODUCT FUNCTIONAL CHARACTERISTICS PUBLICATION DESCRIBES THE MACHINE CHECK INTERRUPT CODE SUPPORT. 


--- MACHINE CHECK INTERRUPT CODE --- 


--- SUB CLASS --- 
SYSTEM DAMAGE (SD) 0 CLOCK DAMAGE (CD) @) 
PROC.DAMAGE (PD) 0 WARNING (W) re) 
SYSTEM RECOVERY (SR) 0 DEGRADATION (DG) 0 
-~-- INTERRUPT TENSE CODES --- 
--- STORAGE AND PROTECTION ERROR CODES --- 
UNCORRECTED STORAGE ERRORS (SE) 0 KEY IN STOR ERR(KE) 0 
CORRECTED STORAGE ERRORS (SC) 0 STOR DEGRADATION (DS) @) 
--- PSW VALIDITY CODES --- 

EMWP BITS OF M.C. OLD ARE VALID (WP) 1 SYSTEM MASK OF M.C. OLD IS VALID (MS) 1 
PROGRAM MASK OF M.C. OLD IS VALID (PM) 1 INSTR ADDR OF M.C. OLD IS VALID (IA) 1 

--- MISC VALIDITY CODES --- 
FAILING STORAGE ADDR IS VALID (FA) 0 INSTR MODIFIED STORAGE IS VALID (ST) 1 
FP REGS STORED ARE VALID (FP) 1 GP REGS STORED ARE VALID (GP) 1 
CONTROL REGS STORED ARE VALID (CR) 1 CLOCK COMPARATOR STORED IS VALID(CC) 1 
REGION CODE IS VALID (RC) O 
EXTERNAL LOGOUT AREA IS VALID(CC) re) EXTERNAL DAMAGE CODE IS VALID (EC) 1 
EXTENDED LOGOUT LENGTH 0000 FAILING STORAGE ADDRESS 00000000 

--- EXTERNAL DAMAGE CODE --- 
EXTERNAL SECONDARY REPORT 1 CHANNEL NOT OPERATIONAL 0 
I/O INTERRUPT TIMEOUT 1 I/O INSTRUCTION TIMEOUT O 


--- REGION CODE --- 


DAMAGE DURING I/0 INSTRUCTION DEVICE 0000 
HHI HK RR IR IRR IR RIKER RIKER RAK KEKE KKK KKK KK RK 


Figure 2-29 (Part 1 of 2). MCH Detail Edit Report 
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MCH Detail (PRINT) Reports 


~-- FLOATING POINT REGISTERS --- 
FP REGS 0,2 
FP REGS 4,6 


--- GENERAL PURPOSE 


GP REGS 0-3 
GP REGS 4-7 
GP REGS 8-B 
GP REGS C-F 


~-- CONTROL 


GP REGS 0-3 
GP REGS 4-7 
GP REGS 8-B 
GP REGS C-F 


00 00 
00 00 


00 
00 


00 00 
40 01 
00 3D 
00 O1 


00 
C8 
03 
C3 


00 00 00 
00 00 00 
00 00 00 


00 
00 


00 
F4 
80 
A8 


00 
80 
00 
00 


REGISTERS --- 
80 80 OE CO 


09 
00 
00 
00 


00 
00 
00 


--- MACHINE CHECK LOGOUT BYTES 


0000 
0030 
0060 
0090 
0O0CO 
OOFO 


HEX 


04010F3D 
00000000 
00000000 
00000000 
070D0000 
A33A1F48 


DUMP 0O 


HEADER 


Figure 2-29 (Part 2 of 2). 


0018 
0038 
0058 
0078 
0098 
O0OB8 
00D8 
OOF8 
0118 
0138 
0158 
0178 
0198 
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00030000 
00000000 
00000000 
00000000 
003CDC98 
00000000 


F RECORD 
10660800 
D9OD4E2E3 
00000000 
00000000 
00000000 
00000000 
00000000 
4001C8F4 
0001C3A8 
00000000 
00000000 
00000000 
00000000 
003D0380 


00000000 
00000000 
00000000 
00000000 
0001C3A8 
00000000 


00000000 
C5C74040 
22000000 
00000000 
00000000 
00000000 
00000000 
8001D2F0 
OO1FA1A8 
00000000 
00000000 
00000000 
00000000 
0039BABO 


00 00 
00 00 


0 


01 


3 
1 


3 


00 


0 
0 


00 
00 


00 
00 


REGISTERS --- 


10 
FO 
C8 
A8 


1 CE 
D2 
D 04 
F Al 


co 
00 
00 
00 


C ES 
00 
0 00 
0 00 


22000000 
00000000 
00000000 
0001CE10 
001FA1A8 
00000000 


0086211F 
E3C5C740 
00000000 
00000000 
00000000 
00000000 
00000000 
003D0380 
00395480 
A33A1F48 
CFCOO0000 
00000000 
00000000 


00 
00 


00 
00 


00 
00 
07 
00 


00 
3D 
OD 
39 


FF 
A3 
00 
00 


FF 
3A 
00 
00 


00000000 
00000000 
00000000 
00000000 
00395480 
00000000 


16405155 
40404040 
00000000 
00000000 
00000000 
00000000 
00000000 
00000034 
00033584 
00000000 
00000000 
00000000 
00000002 


MCH Detail Edit Report 


00 
00 


00 
03 
00 
54 


FF 
1F 
00 
00 


00 
00 


00 
00 


00 
80 
00 
80 


00 
00 
00 
00 


FF 
48 
00 
00 


00 
00 
00 
00 


00 
00 


01 
00 
3C 
03 


00 
00 
00 
00 


00 
00 


D2 
00 
DC 
35 


00 
00 
00 
00 


00 
00 


EC 
34 
98 
84 


00 
00 
00 
00 


00000000 
00000000 
00000000 
0001D2EC 
00033584 
00000000 


00010620 
000C0000 
00000000 
00000000 
00000000 
00000000 
00000000 
003D0380 
80800ECO 
00000000 
00580000 
00000000 
00000000 


00000000 
00000000 
00000000 
4001C8F4 
80800ECO 
00000000 


93730000 
0001C90A 
00000000 
00000000 
00000000 
00000000 
0001CE10 
003D04C8 
093CE5CO 
00000000 
00000000 
00000000 
00000000 


00000000 
00000000 
00000000 
8001D2F0 
093CE5CO 
00000000 


04010F3D 
00000000 
00000000 
00000000 
00000000 
00000000 
070D0000 
FRFFFFFF 
00000000 
80000000 
00000000 
00000000 


00000000 
00000000 
00000000 
003D0380 
FFFFFFFF 
CFCO0000 


00030000 
00000000 
00000000 
00000000 
00000000 
0001D2EC 
003CDC98 
00000000 
00000000 
00000004 
00000000 
00000000 


00000000 
00000000 
00000000 
00000034 
00000000 
00000000 


00000000 
00000000 
00000000 
003D0380 
00000000 


00000000 
00000000 
00000000 
003D04C8 
00000000 





MCH Detail (PRINT) Reports 


MODEL 9373 MACHINE CHECK RECORDS DAY YEAR DAY YEAR 
DATE RANGE - FROM 211 86 TO 219 86 
SERIAL NO. 010620 
NO.OF RECORDS 00011 


--- SUMMARY OF MODEL 9373 MACHINE CHECK RECORDS --- 


--- MACHINE CHECK INTERRUPT CODE --- 


--- SUB CLASS --- 
SYSTEM DAMAGE (SD) 0000 CLOCK DAMAGE (CD) 0000 
PROC.DAMAGE (PD) 0000 EXTERNAL DAMAGE (ED) 0011 
SYSTEM RECOVERY (SR) 0000 AUTO-CONFIG (AC) 0000 
TIMER DAMAGE (TD) 0000 WARNING (W) 0000 


--- INTERRUPT TENSE CODES --- 
BACK-UP (B) 0000 DELAYED (D) 0005 


--- STORAGE AND PROTECTION ERROR CODES --- 
UNCORRECTED STORAGE ERRORS (SE) 0000 UNCORRECTED PROTECTION ERRORS (PE) 0000 
CORRECTED STORAGE ERRORS (SC) 0000 STORAGE DEGRADATION (DS) 0000 


Figure 2-30. MCH Detail Summary Report 
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MDR Detail (PRINT) Reports 


---RECORD ENTRY TYPE - NCP MDR 
VS 2 REL. 06 
DAY YEAR 
DATE- 063 80 


DEVICE TYPE 3705 
CHANNEL UNIT ADDRESS 051D 
RESOURCE I.D. F850 


RECORD TYPE - BSC/SS PERMANENT LINE ERROR 
LIB ADDR. 002C 
TERMINAL NAME D004 


BASIC TRANSMISSION UNIT 
BTU COMMAND 02 

BTU MODIFIER OA 

BTU FLAGS 1000 


IOB COMMAND 
IOB MODIFIERS 


INITIAL ERROR STATUS 06 
FIRST BYTE 

EXTENDED ERR STAT FLG 0 

FORMAT EXCEPTION FLAG 0 


SOURCE - OUTBOARD 


HH 
TIME 08 


AC 
0000 


IOB IMMED CTL CMMND 00 


INITIAL ERR EXT STAT 00 


OVERRUN/UNDERRUN FLAG 0 
LINE QUIET TIMEOUT FG 0 


SYNC CHECK FLAG 0 LEADING DLE FORMAT CH 0 
DATA CHECK FLAG 0 SUB BLOCK ERROR FLAG 0 
PH ER 0 UNUSED 0 
AS RO i UNUSED 0 
E R 4 UNUSED 0 
LENGTH CHECK FLAG 0 UNUSED 0 
SIO COUNTER 0000 TEMPORARY ERROR COUNTER 00 
2770 00 
HEX DUMP OF RECORD 
HEADER 91460800 O058A0000 0080063F 08472210 
C018 O51DC4F0 FOF44040 4040F850 002C0005 


0038 00005087 4c 


Figure 2-31. MDR Detail Edit Report 
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MODEL- 3031 


MM SS.TH 
47 22 10 


IOB INITIAL ERROR STATUS 


SERIAL NO. 037961 


0680 


IOB INITIAL ERR EXT STAT 00 


IOB STATUS 


IOB EXTENDED STATUS 


LAST ERROR STATUS 06 
FIRST BYTE 

EXTENDED ERR STAT FLG 0 

FORMAT EXCEPTION FLAG 0 


SYNC CHECK FLAG 0 LEADING DLE FORMAT CH 0 

DATA CHECK FLAG 0 SUB BLOCK ERROR FLAG 0 

PH ER 0 UNUSED 6) 

AS RO ag UNUSED 0 

E R a UNUSED 0 

LENGTH CHECK FLAG 0) UNUSED 0 

00037961 30310588 

020A1000 ACO00000 06800006 80000000 


0680 
00 


LAST ERR EXT STAT 00 


OVERRUN/UNDERRUN FLAG O 
LINE QUIET TIMEOUT FG 0 


N 
ve 


J 


---SUMMARY OF ENTRY TYPE - 3705 MDR 
DAY YEAR 
063 


DATE RANGE- 
CHANNEL UNIT ADDRESS 00051D 


DAY YEAR 


80 TO 063 


80 


DEVICE TYPE 3705 


MODEL- 3031 


TOTAL NUMBER OF RECORDS 0021 


MDR Detail (PRINT) Reports 





SERIAL NO. 037961 





LIB TEMP PERM MODEM/ 
TERM NAME RID ADDR # 1/0 OPS ERRORS ERRORS HDWR TM OUT DATA CK RCV ITV ROD MISC INTFC 
A025 F854 002C 00000000 000000 000003 %% 00000 00003 00000 00000 00000 00000 00000 
B020 F801 002C 00000000 000000 000002 %% 00000 00002 00000 00000 00000 00000 00000 
BO21 F80B 002C 00000000 000000 000001 %% 00000 00001 00000 00000 00000 00000 00000 
BO22 F819 002C 00000000 000000 000001 %% 00000 00001 #00000 00000 00000 00000 00000 
B023 F827 002C 00000000 000000 000001 %% 00000 00001 #00000 00000 00000 00000 00000 
BO24 F835 002C 00000000 000000 000001 %% 00000 00001 00000 00000 00000 00000 # 00000 
BO25 F843 002C 00000000 000000 000001 %% 00000 00001 00000 00000 00000 00000 00000 
B101 F84E 002C 00000000 000000 000005 %% 00000 00005 00000 00000 00000 00000 00000 
D003 F84F 002C 00000000 000000 000003 %% 00000 00003 00000 00000 00000 00000 00000 
D004 F850 002C 00000000 000000 000003 %% 00000 00003 00000 00000 00000 00000 00000 
Figure 2-32. MDR Detail Summary Report 

Note: As of EREP 2.3, there is no Detail Edit or Summary of DASD MDR 
records. See “33XX DASD” in Part 4. 
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MIH Detail (PRINT) Reports 





~-- RECORD ENTRY TYPE - MIH SOURCE - MIH MODEL - 


VS 2 REL. 03 

DAY YEAR HH.MM.SS.TH 
061 80 18 34 07 25 

UCB DEVICE TYPE 00001008 

PRIMARY CHANNEL UNIT ADDRESS 000234 

ALTERNATE CHANNEL UNIT ADDRESS 000234 

CHANNEL SET ID 01 

MISSING INTERRUPT 40 

TIME INTERVAL 00012345 

VOLUME SERIAL NUMBER 111111 


HEX DUMP OF RECORD 
HEADER 70830800 40011100 OO80061F 18340725 


0000 C4E4D4D4 E8D4C9C8 0002340D 0234F1F1 


Figure 2-33. MIH Detail Edit Report for 370-Mode Records 


SUMMARY OF MIH RECORDS CUA 0004A1 


DAY YEAR DAY YEAR 
RECORD DATE RANGE 061 80 061 80 


MODEL - 3033 SERIAL NO - 021929 


TOTAL NUMBER OF RECORDS=0004 


3033 SERIAL NO. 025791 


JOB IDENTITY DUMMYMIH 


C4E4D4D4E8D4C9C8 


00025791 30330000 


FIFIF1F1 O000080D FOFOFOF1 


Figure 2-34. MIH Detail Summary Report for 370-Mode Records 
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F2F3F4F5 


= 





MIH Detail (PRINT) Reports 





DEVICE NUMBER: O4AC REPORT: MIH EDIT DAY YEAR 
SCP: VS 2 REL. 3 DATE: 112 82 
DEVICE TYPE: 3330 
CPU MODEL: 3081 HH MM SS.TH 


CHANNEL PATH ID: N/A 


MISSING INTERRUPT: 10 ~- START PENDING IN SUBCHANNEL 


HH MM SS.TH 


TIME INTERVAL: 00 00 


CPU SERIAL: 220015 


TIME: 10 03 03.98 


VOLUME SERIAL: 
UCB LEVEL BYTE: 
15.00 


RECOVERY ACTIONS PERFORMED BYTE: ac [f¥ 


HALT OR CLEAR SUBCHANNEL 


SIMULATED INTERRUPT 
REDRIVE DEVICE 
REQUEUE I/O REQUEST 
ISSUE MESSAGE 

LOG THE CONDITION 
BIT 6 

BIT 7 


HEX DUMP OF SUBCHANNEL 


ob 
0 
1 
0 
al 
1 
0 
0 


INFORMATION BLOCK 


Notes: 


OFFSET OOF96710 289B04AC AO0020FO O1C5BFFO 
0010 04241116 FEFFFFFFF 00000000 00004400 
0020 OODO005BO0 10000000 6B1F3001 292711F7 
0030 00000935 
HEX DUMP OF RECORD 
HEADER 71831800 00000000 0082112F 10030398 03220015 30810000 
0018 C5F1F7D1 C1C4F1Cl1 OO0F96710 289B04AC AO00020FO O01C5BFFO 
0038 00000000 00004400 OOD005BO 10000000 6B1F3001 292711F7 
0058 F1FSFOFO 10BCBCAC 000101DC 2898A020 F0042411 16FFFFFF 
0078 800004AC 08003070 200DD7D6 D2FOF8F7 00000000 
Figure 2-35. MIH Detail Edit Report for 370-XA Records 


Il. The hexadecimal value in the byte is shown here; 


REPORT DATE: 


JOB IDENTITY: E17JADI1A 


C5F1F7D1C1C4F1C1 


SUBCHANNEL ID NUMBER: 0000101DC 


POKO87 

01 
04241116 FFFFFFFF 
00000935 FOFOFOFO 
FFO10000 00000100 


the bit settings are detailed 


118 82 


PERIOD FROM: 112 82 


below it. 
DEVICE NUMBER: O7CA REPORT: MIH SUMMARY 
DEVICE TYPE: 3330 CPU MODEL: 3081 
CPU SERIAL: 020015 


MISSING INTERRUPT 


MISSING CSCH 
MISSING HSCH 


IDLE DEVICE WITH WORK QUEUED 
START PENDING IN SUBCHANNEL 


MOUNT PENDING 


MISSING PRIMARY STATUS 
MISSING SECONDARY STATUS 


00000000 
00000000 
00000000 
00000018 
00000000 
00000000 
00000000 


Figure 2-36. MIH Detail Summary Report for 370-XA Records 


TO: 112 82 
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OBR Detail (PRINT) Reports 


PRIMARY CUA: 


DEVICE TYPE: 


ERROR PATH: 


RECORD IS: 


MODE IS: 


FAILING CCW: 


CSW: 


---UNIT STATUS-- 
ATTENTION 

STATUS MODIFIER 
CONTROL UNIT END 
BUSY 

CHANNEL END 
DEVICE END 

UNIT CHECK 

UNIT EXCEPTION 


DEVICE DEPENDENT 


SYMPTOM CODE 2 
VOLUME SERIAL H 


SENSE BYTE DATA 
= BYTEOO---- 
COMMAND REJECT 
INTRVN REQUIRED 
NOT USED 
EQUIPMENT CHECK 
DATA CHECK 
OVERRUN 

NOT USED 

NOT USED 


=.= 2 BYTEO6---- 
USED 
USED 
USED 
USED 
USED 
USED 
USED 
USED 


Figure 2-37 (Part 1 


JOB IDENTITY: MAINT 


D4C1C9D5E3404040 : 


0C70 REPORT: OUTBOARD (LONG) DAY YEAR 
SCP: VS 2 REL. 3 DATE: 289 86 
9347 
MODEL: 9375 HH MM SS.TH 
0C70 SERIAL: 234567 TIME: 05 35 04.82 
PERMANENT 
370 
cc CA FL CT 


O1 304F0B 20 80 OOA5 


K 
00 


CA uS CS CT 
6A8590 OE 00 OOAS5 
-- CHANNEL STATUS 
PGM-CTLD IRPT 
INCORRECT LENGTH 
PROGRAM CHECK 
PROTECTION CHECK 
CHAN DATA CHECK 
CHAN CTL CHECK 
I/F CTL CHECK 


0 
0 
0 
0 
1 
1 
a 
QO CHAINING CHECK 


DATA 


002 
ISTOT 


NOISE 

DEVICE STATUS A 
DEVICE STATUS B 
NOT USED 

AT LOAD POINT 
WRITE STATUS 
FILE PROTECT 
NOT CAPABLE 


08 


0 
0 
0 
0 
1 
0 
0 
0 


OD: =SS4== BYTEOQ7-~--1 
FORMAT CODE 8 
FORMAT CODE 4 
FORMAT CODE 2 
FORMAT CODE 1 
DATA SECUR ERASE 
NOT USED 

NOT USED 


NOT USED 


ooo oo oOo oO Oo 


of 2). 


a 
0 
0 
0 
1 
0 
0 


0 


Oo0o0OrR0C0 0 0 


oOo oO 0 000 0 


BYTEO3----07 


-------------- Q -------------- 0 
] ] 0 ] ] 0 
] ] 0 ] ERROR ] 0 
] TRACK IN ] O ] RECOVERY ] 0 
] ERR (0-7)  ] 1 ] PROCEDURE ] 0 
] ] 1] (0-7) ] 1 
] ] 0 | ] 1 
-------------- Q -------------- 1 
------ BYTEO8----38 ------BYTE09----38 
BUFFER FULL LOW 0 BOT 0 
BUFFER FULL HIGH O EOT 0 
DRIVE ONLINE 1 TAPE-IN PATH SNR 1 
DRIVE READY 1 WRITE ENABLED 1 
POS. TO MOVE FWD 1 PE 1600 ID BURST 1 
NOT USED 0 PE 3200 ID BURST O 
NOT USED O NOT USED 0 
NOT USED 0 NOT USED 0 


OBR Detail Edit Report for 370 Mode Records 


a eas BYTEO4----10 -----BYTE05----00 
NOT USED O NOT USED O 
NOT USED O NOT USED 0 
TAPE INDICATE 0 NOT USED 0 
PERMANENT ERROR 1 PE-ID CHECK 0 
HOST DETECT ERR O NOT USED 0 
LOOP WRITE-READ O NOT USED 0 
NOT USED 0 NOT USED 0 
NOT USED O NOT USED 0 
a ealaomiariars BYTE10----00 -----BYTE11----00 


DFCI SEQ CHECK 0 DOOR OPENED O 
DFCI PARITY CHK O REEL MISSING 0 
SYNCH INS/OUTS O REEL INVERTED O 
XFER FAILURE O NO BOT 0 
NOT USED O LOAD FAILURE 0 
NOT USED OQ REEL NOT CNTRED 0 
NOT USED O NOT USED 0 
NOT USED 0 P.O.S.T 0 
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C 


==S5= = BYTE12~---00 
TENSION ARM 0 
TAPE SPEED 0 
3700 FT OF TAPE 0 
TENSION ARM VOL 0 
TACHOMETER 0 
SUPPLY HUB LOCK 0 
TAKE-UP HUB SLIP 0 
SUPPLY HUB SLIP 0 


S=—=55 BYTE18----04 
LENGTH 32768 0 
LENGTH 16384 0 
LENGTH 8192 0 
LENGTH 4096 0 
LENGTH 2048 0 
LENGTH 1024 1 
LENGTH 512 0 
LENGTH 256 0 


S=Soae BYTE24----00 
LVL IND BIT1 0 
LVL IND BIT2 0 
LVL IND BIT3 O 
LVL IND BIT4 0 
LVL IND BIT5 O 
USED 0 
USED 0 
USED 0 


(oe) 


] ] 
] FAULT ] 
] SYMPTOM ] 
] CODE ] 
] (MSB) ] 
] ] 


oOo 0 0Fr O 


sScocsosuleosos 0 


See sa BYTE13----C0O 
WRITE CHECK 
WRITE IBG NOISE 
WRITE ID CHECK 
WRT POSTAMBLE CK 
ERASE GAP SIZE 
PIC ERROR 

NOT USED 

NOT USED 


ooo 0 0 OF FF 


=SSSS= BYTE19----00 
LENGTH 128 
LENGTH 64 
LENGTH 32 
LENGTH 16 
LENGTH 
LENGTH 
LENGTH 
LENGTH 


rN & © 
OOo 0 00 00 0 


ai a BYTE25----00 
LVL IND BIT1 0 
LVL IND BIT2 0 
LVL IND BIT3 O 
LVL IND BIT4 0 
LVL IND BITS5 0 
USED 0 
USED 0 
USED 0 


------ BYTE31----02 


] ] 
] FAULT ] 
] SYMPTOM ] 
] CODE ] 
}] (LSB) ] 
] ] 


Ooroao90oa0o oO Oo 


HEX 


DUMP O 


HEADER 
0018 
0038 
0058 
0078 


Figure 2-37 (Part 2 of 2). 


F RECORD 


30660800 
D4C1C9D5 
00000C70 
80000400 
00000000 





OBR Detail (PRINT) Reports 


00000000 
E3404040 
00000020 
00000000 
00000000 


0086289F 
01304F0B 
C8C9E2E3 
00000000 
00000000 


OBR Detail Edit Report for 370 Mode Records 
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------ BYTE14----00 ------BYTE15----80 ------BYTE16----80 
READ SKEW O TIE PARITY 1 1600 CPI/25IPS a 
READ UNCORRECT P O NOT USED 0 1600 CPI/100IPS 0 
READ MCHNL DROP O NOT USED 0 3200 CPI/50IPS 0 
READ ID O NOT USED O NOT USED 0 
NOT USED O NOT USED O NOT USED 0 
NOT USED O NOT USED O NOT USED 0 
NOT USED 0 NOT USED O NOT USED 0 
NOT USED O NOT USED O NOT USED 0 
------ BYTE20----00 ------BYTE21----00 ------BYTE22----00 
1ST LVL IND BIT1 0 2ND LVL IND BIT1 O 3RD LVL IND BIT1 0 
1ST LVL IND BIT2 O 2ND LVL IND BIT2 O 3RD LVL IND BIT2 0 
1ST LVL IND BIT3 0 2ND LVL IND BIT3 O 3RD LVL IND BIT3 0 
1ST LVL IND BIT4 0 2ND LVL IND BIT4 O 3RD LVL IND BIT4 O 
1ST LVL IND BIT5 O 2ND LVL IND BIT5 O 3RD LVL IND BITS O 
NOT USED O NOT USED O NOT USED 0 
NOT USED O NOT USED O NOT USED 0 
NOT USED O NOT USED O NOT USED 0 
------ BYTE26----00 ------BYTE27----00 ------BYTE28----00 
NOT USED Q -------------- Q -------------- 0 
NOT USED O ] ] 0 ] ] 0 
NOT USED 0 ] ] 0 ] ] 0 
NOT USED 0 ] CONDITION ] 0 ] DIAGNOSTIC ] 0 
NOT USED 0 ] FLAG ] 0 ] LED ] 0 
NOT USED 0 ] ] 0 ] ] 0 
NOT USED 0 ] ] 0 ] ] 0 
NOT USED Q -------------- Q -------------- 0 
05350482 10234567 93750000 
208000A5 006A8590 OEO0O00A5 01000C70 00008009 
D6E30000 08440C07 10000010 38380000 00Cc00080 
00002002 00000000 00000000 00000000 00000000 


-BYTE17----4 


USED 
USED 
32 
16 


PN & © 


-BYTE23----¢ 


LVL 
LVL 
LVL 
LVL 
LVL 
USED 
USED 
USED 


IND 
IND 
IND 
IND 
IND 


BT1l 
BT2 
BT3 
BT4 
BT5 


-BYTE29----q 


USED 
USED 
USED 
USED 
USED 
USED 
USED 
USED 


22 


77 


OBR Detail (PRINT) Reports 


DEVICE NUMBER: 00 
DEVICE TYPE: 93 
ERROR PATH: 00 
RECORD IS: PE 
MODE IS: 37 


FAILING CCW: 
SCSW: 


==sUNIT STATUS-==- 
ATTENTION 0 
STATUS MODIFIER 0 
CONTROL UNIT END QO 
BUSY 0 
CHANNEL END 0 
DEVICE END 0 
UNIT CHECK 0 
UNIT EXCEPTION 0 
DEVICE DEPENDENT D 
SYMPTOM CODE 200 
VOLUME SERIAL HIS 


SENSE BYTE DATA 
= BYTEOO----08 
COMMAND REJECT 0 
INTRVN REQUIRED 0 
NOT USED 0 
EQUIPMENT CHECK 0 
DATA CHECK 1 
OVERRUN 0 
NOT USED 0 
NOT USED 0 


BYTEO6----00 
USED 
USED 
USED 
USED 
USED 
USED 
USED 
USED 


oOo oO 0 000 0 


Figure 2-38 (Part 1 


0C70 REPORT: OUTBOARD (LONG) DAY YEAR 
SCP: VS 2 REL. 3 DATE: 289 86 
47 
MODEL: 9375 HH MM SS 
-0C70 SERIAL: 234567 TIME: 05 35 04 
RMANENT 
OXA 
cc CA FL CT 
01 304F0B 20 80 OOAS5 
K FLAGS CA uS CS CT 
00 000000 00000000 00 00 0000 
SUB-CHANNEL STATUS -------------------------- SCSW FLAGS 
PGM-CTLD IRPT O CCW FORMAT QO RESERVED 
INCORRECT LENGTH 0 PRE-FETCH CCW O SSCH FUNCTION 
PROGRAM CHECK QO INIT STATUS O HSCH FUNCTION 
PROTECTION CHECK 0 ADDR LIMIT O CSCH FUNCTION 
CHAN DATA CHECK 0 SUPP SUSPEND INT 0 RESUME PENDING 
CHAN CTL CHECK 0 ZERO COND CODE 0 START PENDING 
I/F CTL CHECK QO EXTENDED CONTROL 0 HALT PENDING 
CHAINING CHECK 0 PATH NOT OPER QO CLEAR PENDING 
ATA 
2 
TOT 
------ BYTEOQ1----44 ------BYTE02----0C ------BYTE03----07 
NOISE Q -------------- Q -------------- ) 
DEVICE STATUS A 1 ] } OO] 1 Oo 
DEVICE STATUS B 0 ] ] O ] ERROR ] 0 
NOT USED QO ] TRACK IN ] OO] RECOVERY ] OO 
AT LOAD POINT O ] ERR (0-7) J] 1] PROCEDURE] 0O 
WRITE STATUS 1.) ] Lek *4O=7) ] 1 
FILE PROTECT Oo ] } Oo] } 1 
NOT CAPABLE Q -------------- Q -------------- 1 
------ BYTEQ7----10 ------BYTE08----38 ------BYTEO9----38 
FORMAT CODE 8 O BUFFER FULL LOW O BOT 0 
FORMAT CODE 4 Q BUFFER FULL HIGH O EOT 0 
FORMAT CODE 2 OQ DRIVE ONLINE 1 TAPE-IN PATH SNR 1 
FORMAT CODE 1 1 DRIVE READY 1 WRITE ENABLED 1 
DATA SECUR ERASE 0 POS. TO MOVE FWD 1 PE 1600 ID BURST 1 
NOT USED © NOT USED OQ PE 3200 ID BURST 0 
NOT USED OQ NOT USED © NOT USED 0 
NOT USED OQ NOT USED OQ NOT USED 0 
of 2). OBR Detail Edit Report for 370-XA Mode Records 
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JOB IDENTITY: MAINT 


D4C1C9D5E3404040 ) 


. TH 

82 

O SUBCHANNEL ACTIV 0 

O DEVICE ACTIVE 0 

O SUSPENDED 0 

O ALERT STATUS 0 

O INTERMED STATUS 0 

O PRIMARY STATUS 0 

QO SECONDARY STATUS 0 

O STATUS PENDING 0 

=—S=—= BYTEO4----10 -----BYTE0O5----00 
NOT USED 0 NOT USED 0 
NOT USED 0 NOT USED 0 : 
TAPE INDICATE 0 NOT USED 0 7 
PERMANENT ERROR 1 PE-ID CHECK 0 
HOST DETECT ERR O NOT USED 0 
LOOP WRITE-READ O NOT USED 0 
NOT USED QO NOT USED 0 
NOT USED 0 NOT USED 0 
SS BYTE10----00 -----BYTE11---~-00 
DFCI SEQ CHECK 0 DOOR OPENED ) 
DFCI PARITY CHK O REEL MISSING 0 
SYNCH INS/OUTS O REEL INVERTED 0 
XFER FAILURE O NO BOT 0 
NOT USED 0 LOAD FAILURE 0 
NOT USED QO REEL NOT CNTRED 0 
NOT USED O NOT USED 0 
NOT USED 0 P.O.S.T 0 


SSeS BYTE12----00 
TENSION ARM 0 
TAPE SPEED 0 
3700 FT OF TAPE 0O 
TENSION ARM VOL 0 
TACHOMETER 0 
SUPPLY HUB LOCK 0 
TAKE-UP HUB SLIP 0O 
SUPPLY HUB SLIP 0 


res BYTE18----04 
LENGTH 32768 
LENGTH 16384 
LENGTH 8192 
LENGTH 4096 
LENGTH 2048 
LENGTH 1024 
LENGTH 512 
LENGTH 256 


OoOOrOO Oo 0 0 


ee BYTE24----00 
LVL IND BIT1 
LVL IND BIT2 
LVL IND BIT3 
LVL IND BIT4 
LVL IND BIT5 
USED 
USED 
USED 


oo ooo0o0 } 


Oo 


] ] 
] FAULT ] 
] SYMPTOM ] 
] CODE ] 
] (MSB) ] 
] ] 


oo OOF O 


Oo 


HEX DUMP OF RECORD 


aga a BYTE13----CO 
WRITE CHECK 
WRITE IBG NOISE 
WRITE ID CHECK 
WRT POSTAMBLE CK 
ERASE GAP SIZE 
PIC ERROR 

NOT USED 

NOT USED 


oo oO 0 OOF F 


<== BYTE19----00 
LENGTH 128 
LENGTH 64 

LENGTH 
LENGTH 
LENGTH 8 
LENGTH 4 
LENGTH 2 
LENGTH 1 


ooo o0o0co CO 8 


------ BYTE25----00 


a a BYTE14----00 
READ SKEW 

READ UNCORRECT P 
READ MCHNL DROP 
READ ID 

NOT USED 

NOT USED 

NOT USED 

NOT USED 


ooo o0o0o0 oO Oo 


=—SS55 > BYTE20----00 
LVL IND BIT1 
LVL IND BIT2 
LVL IND BIT3 
LVL IND BIT4 
LVL IND BITS5 
USED 
USED 
USED 


oo oo 0o00 © 


------ BYTE26----00 


OBR Detail (PRINT) Reports 


------ BYTE15----80 ------BYTE16----80 
TIE PARITY 1 1600 CPI/25IPS 1 
NOT USED © 1600 CPI/100IPS 0 
NOT USED 0 3200 CPI/50IPS 0 
NOT USED O NOT USED 0) 
NOT USED O NOT USED 0 
NOT USED O NOT USED 0) 
NOT USED O NOT USED 0) 
NOT USED O NOT USED 0) 
------ BYTE21----00 ------BYTE22----00 
2ND LVL IND BIT1 O 3RD LVL IND BIT1 0 
2ND LVL IND BIT2 O 3RD LVL IND BIT2 0 
2ND LVL IND BIT3 O 3RD LVL IND BIT3 0 
2ND LVL IND BIT4 O 3RD LVL IND BIT4 0 
2ND LVL IND BITS O 3RD LVL IND BITS 0 
NOT USED O NOT USED @) 
NOT USED O NOT USED 0 
NOT USED O NOT USED @) 


------ BYTE28----00 


HEADER 
0018 
0038 
0058 
0078 


Figure 2-38 (Part 2 of 2). 


30661800 
D4C1C9D5 
00000C70 
80000400 
00000000 


6TH LVL IND BIT1 0 
6TH LVL IND BIT2 0 
6TH LVL IND BIT3 0 
6TH LVL IND BIT4 O 
6TH LVL IND BITS O 
NOT USED 0 
NOT USED 0 
NOT USED 0 
------ BYTE31----02 
io i es es ee O 
] ] 0 
] FAULT ] 0 
] SYMPTOM ] 0 
] CODE ] 0 
] (LSB) ] 0 
] ] 1 
i a ek ke le O 
00000000 0086289F 
E3404040 01304FOB 
00000020 C8C9E2E3 
00000000 00000000 
00000000 00000000 


OBR Detail Edit Report for 370-XA Mode Records 
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NOT USED Q -------------- Q -------------- 0 
NOT USED 0 J ] 0 ] ] 0 
NOT USED 0 J ] 0 ] ] 0 
NOT USED 0 ] CONDITION ] OQ ] DIAGNOSTIC ] ) 
NOT USED 0 ] FLAG ] 0 ] LED ] 0 
NOT USED 0 ] ] 0 ] ] 0 
NOT USED 0 ] ] 0 ] ] 0 
NOT USED Q -------------- Q -------------- @) 
05350482 10234567 93750000 
208000A5 0O06A8590 OEOOOOAS 01000C70 00008009 
D6E30000 08440C07 10000010 38380000 00c00080 
00002002 00000000 00000000 00000000 00000000 


-BYTE17----00 
USED 
USED 
32 
16 


oo oc 000 0 


FN & © 


-BYTE23----00 
LVL IND BTl 
LVL IND BT2 
LVL IND BT3 
LVL IND BT4 
LVL IND BTS 
USED 
USED 
USED 


ooo 0o0o0c00c Oo 


-“BYTE2Z9=-=-00 
USED 
USED 
USED 
USED 
USED 
USED 
USED 
USED 


oo oo 000 0 
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OBR Detail (PRINT) Reports 


DEVICE NUMBER: 000002 REPORT: OUTBOARD SUMMARY REPORT DATE: 042 87 
MODEL: 3081 PERIOD FROM: 087 84 

DEVICE TYPE: 3211 SERIAL: 020447 TO: 159 84 

TOTAL NUMBER OF RECORDS 041 TOTAL OF OVERFLOW RECORDS 000 

CCW COMMAND CODES ENCOUNTERED(MAXIMUM OF 24) 

CMND TOTAL 

OB 041 

STATISTICAL DATA SUMMARY 

TEMPORARY READS 000 TEMPORARY WRITES 000 

NOT USED 000 BUS OUT PAR CHK 000 

EQUIPMENT CHECK O00 BUFR PARITY CHK 013 

LOAD CHECK 045 NOT USED 000 

COMMAND RETRY 000 PRINT CHECK 000 

PRINT QUALITY 000 LINE POSITION 000 

NOT USED 000 CMD SUPPRESS 045 

NOT USED 000 CHAN DATA CHECK 000 

NOT USED 000 NOT USED 000 

NOT USED 000 NOT USED 000 

SENSE BIT DATA SUMMARY 

aaa a BYTE. OO" =" > SH = sS=BYTE Ol] o> SS Ae BYTE: O26=S—= —=—===—BYTE. O3=s3=— =-H==BYTE 04-——==* =<--- 

COMMAND REJECT O00 COMMAND RETRY OO CARRIAGE F MOV OO UCB PARITY OO EXTRA SCAN 00 

INTRVNTN REQ'D OO PRINT CHECK 00 CARRIAGE SQ CHK OO PLB PARITY 0O PRINT TRIG 00 

BUS OUT PAR CHK 00 PRINT QUALITY OO CARRIAGE SP CHK OO FCB PARITY OO BLK PRINT 00 

EQUIPMENT CHECK 00 LINE POSITION OO PLT F ADVANCE 04 COIL PROTECTION 00 PLAT INTERLOCK 00 

DATA CHECK OO FORMS CHECK 41 PLT F RETRY OO H. FIRE CHK 00 CARRIAGE GO 00 

BUFR PARITY CHK 09 CMD SUPPRESS 41 FORMS JAM 00 SERVICE AID 00 CARRIAGE SETTL 00 

LOAD CHECK 41 MECH MOTION 14 RIBBON MOTION 00 UCSAR S C 00 CARRIAGE COMPR 00 

CHANNEL NINE(9) 41 BIT 7 NOT USED 00 TRAIN OVERLOAD 00 PSE S CHECK OO FORWARD DRIVE 00 


Figure 2-39. OBR Detail Summary for 370 Mode Records 
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NO UB WN Ff OO 


OBR Detail (PRINT) Reports 





SUMMARY OF I/O RECORDS TYPE-OBR/SDR/MDR SOURCE-OUTBOARD/MISC DEVICE 3800 MOD 3,8 CPU MODEL- 0158 SERIAL NO. 024706 
DAY YEAR DAY YEAR 
DATE RANGE 001 82 T0 032 2 
NO. OBR SHORT RECORDS 0004 
NO. OBR LONG RECORDS 0024 


NO. MDR RECORDS 0003 
CHANNEL UNIT ADDRESS/DEVICE NUMBER 0190 TOTAL NUMBER OF RECORDS 0031 
--SUMMARY BY ERROR TYPE (COUNTS IN DECIMAL) -- 
SDR counters Mas LONG OBR oata Wd MDR recoros Mem 

TEMP CHL DATA CK 0065 CFS MISFOLD (32) 0065 PERM CHL DATA CK 0000 INTVN RQD CK 0024 NO. INT LOG ENTRY 0024 
TEMP CHL CTL CK 0065 BUR/TRIM JAM(40) 0065 PERM CHL CTL CK 0000 EQUIP CK 0024 
TEMP INTF CTL CK 0065 NO BURST CK (41) 0065 PERM INTF CTL CK 0000 TEMP BOPAR 0000 

BUR/STKR JAM(42) 0065 PERM BOPAR 0001 


--SUMMARY OF PERMANENT ERRORS FROM OBR RECORDS BY STATUS CODE (SENSE BYTE 4) - COUNTS IN DECIMAL 


11 XFR UNDETENTED 0001 33 DATA WIDTH CK Q000 73 RPG SHIFTER CK 0000 95 POST XFR CRNA QO000 B3 PLTN OVTEMP 0000 
14 XFR ST/SP CK 0001 34 FSR OUTPUT CK 0000 74 STRIP BUFFR CK 0000 96 LSR PWR SUPPLY 0000 B4 PLN THRM OPEN 0000 
15 XFR MISREG/JAM 0000 3B X/F PG CT CK 0000 75 CG XEQ CS CK 0000 97 MIRROR DR CK 0000 B5 HR THRMSTR OPN 0000 


16 XFR ENCODER CK 0000 43 EARLY BURST CK 0001 76 LASER POWER CK 0000 98 DVM CHECK 0000 B6 FSR CURRENT CK 0000 
17 XFR MTR OVRLD 0000 4B BTS LOOP CK 0001 77 MIRROR SPD CK 0000 B7 THERMAL- NO CK 0000 
18 XFR PRT POS CK 0000 78 SERIALIZER CK 0000 AO PRNT PWR NRDY 0001 B8 NVS CHEcK 0000 
1C XFR TRACTOR CK 0000 51 MISSING FO FLH 0001 79 SRLZR INTRF CK 0000 B9 PROC PAPER CK 0000 


1E X/F LOOP CK 0000 52 EXTRA FO FLASK 0001 7A MIRR ROTATE CK 0000 A2 PROC VOLT CP 0000 BA SYS CHNL CK 0000 


62 PRINT CONTRAST 0001 7C SER SYNCH CK 0000 A3 LOGIC VOLT CP 0000 BB DISK FILE CK 0000 
21 FSR TEMP CK 0001 63 VACUUM SYS CK 0001 7D S/B OVER-RUN 0000 A4 MIRROR MTR TH OOOO BC FILE READ CK 0000 
22 PLATN TEMP CK 0001 64 OPT STP LMT CK 0000 7E CG CS START CK 0000 AS DR COOLR CHECK 0000 BD FILE WRITE CK 0000 
23 FSR BUR NCLOSD 0000 65 CLNR BRUSH CK 0000 7F CG CS CMPLT CK 0000 A6 CYC BLWR MT TH 0000 BF DISK DAMAGED 0000 
24 FSR BUR NOPEN 0000 66 ERASE LAMP CK Q000 80 RETRY G LOG FL 0001 A7 DEV MOTOR THRM 0000 DO EXGRF-CGEN CK 0001 
25 FSR PRT ALGNMT 0000 67 MARK SENSOR CK 0000 89 PERM IEU PE 0001 A8 CLNR BR MTR TH 0000 D1 X/G CPS CHECK 0001 
26 FSR WIDTH CK 0000 68 DRUM SLOW 0000 8B SUBSYS CLK CK 0000 A9 CTL ASM GT TH Q000 D2 X/G RD WR CK 0000 
27 FSR MTR OVRLD Q000 69 DRUM FAST 0000 8D SUC PRT RSTART 0000 D3 EXGRF-DECOMP CKO000 
28 FSR PAPER SKEW 0000 6A DRUM MTR OVLD O000 8E SUBSYS RUN RST 0000 AB FSR SCFF MT TH 0000 D4 CPS ER-DECOMP 0000 
2A X/F SHORT LOOP 0000 6C TONER OVRFEED O000 8F CHAN SEL RESET 0000 AC CFS ELEV MT TH 0000 D8 ACCUMULATOR CK 0000 
2B X/F LONG LOOP 0000 6D TONER LOOP OPN 0000 90 PROC CLOCK CK 0001 AD CFS MOTOR THRM 0000 D9 ACCUM STRG CK 0000 
2E FSR ROLL WRAP 0000 91 CHARGE CRNA CK 0001 AE MUL THRM SW CK 0000 DA ACCUM/SB CK 0000 

70 CGEN INTRF CK 0001 92 XFR CORONA CK OQO00 AF FSR THERM CHK 0000 DB NO RSP TIMEOUT 0000 
30 OUTPT LNGTH CK 0001 71 CGEN CNTRL CK 0001 93 PRCLN CRNA CK 0000 B1 BTS CAM MT TH 0001 DD CPS RD/WR CK 0000 
31 DRDY LNGTH CK 0001 72 RPG CHECK 0000 94 MAG BR BIAS CK 0000 B2 FSR ROLL OVR T 0000 ODF EXGRF DEC CK 0000 


--SUMMARY OF RECOVERED ERRORS FROM MDR RECORDS BY STATUS CODE (INTERNAL LOG ENTRY BYTE 0) - COUNTS IN DECIMAL-- 


51 MISSING FO FLH 0002 72 RPG CHECK 0000 79 SRLZR INTRF CK 0000 93 PRCLN CRNA CK 0000 D1 X/G CPS CHECK 0002 
52 EXTRA FO FLASH 0000 73 RPG SHIFTER CK 0000 7C SER SYNCH CK 0000 94 MAG BR BIAS CK 0000 D2 X/G RD WR CK 0000 
63 VACUUM SYS CK 0002 74 STRIP BUFFR CK 0000 7D S/B OVER-RUN 0000 95 POST XFR CORONAQOOO D8 ACCUMULATOR CK 0000 
65 CLNR BRUSH CK 0000 75 CG XEQ CS CK 0000 7E CG CS START CK 0000 96 LSR PWR SUPPLY 0000 D9 ACCUM STRG CK 0000 
66 ERASE LAMP CK 0000 76 LASER POWER CK 0000 7F CG CS CMPLT CK 0000 97 MORROR DR CK 0000 DA ACCUM/SB CK 0001 


6A DRUM MTR OVLD 0000 77 MIRROR SPD CK 0000 BA SYS CHNL CK 0002 
70 CGEN INTRF CK 0002 78 SERIALIZER CK 0000 91 CHSRGE CRNA CK 0002 BC FILE READ CK 0009 
71 CGEN CNTRL CK 0000 BD FILE WRITE CK 0000 


--SUMMARY OF STATISTICAL USAGE DATA FROM INTERNAL LOG FOR DATE RANGE INDICATED ABOVE - COUNTS IN DECIMAL-- 


BTS COUNT 000000015900 
CFS FEET COUNT 000001524300 
PAPER COUNT 000000102900 


Figure 2-40. OBR/MDR Summary 
Notes: 


I. The statistical data counters keep track of the number of temporary data and 
equipment checks experienced by the device. 


2. OBR records reflect permanent (that is, uncorrectable) data and equipment 
checks. In this report, the data is from long OBR records only. See “Outboard 
(OBR) Records” on page 10-39. 


3. Error information kept on the device's internal log becomes MDR records. This 
column shows the number of entries in the log; the data is summarized below as 
recovered errors. 
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OBR Detail (PRINT) Reports 


SUMMARY OF I/O OUTBOARD ENVIRONMENT RECORDS FOR DEVICE 000571 DEVICE TYPE 3420 TU SERIAL N/A 
CPU MODEL 3084 
CPU SERIAL 221128 J 
DAY YEAR DAY YEAR 
OUTBOARD DATE RANGE - 130 84 TO 217 85 


TOTAL NUMBER OF RECORDS 003 
VOLUME LABELS ENCOUNTERED (MAXIMUM OF 10 ENTRIES) 


VOL. LABEL 64528 001 
VOL. LABEL 177618 001 
VOL. LABEL 169375 001 


CCW COMMAND CODES ENCOUNTERED(MAXIMUM OF 24 ENTRIES) 
CMND TOTAL 
SENSE BYTES SUMMARY 


BYTE O BYTE 1 BYTE 2 BYTE 3 BYTE 4 BYTE 5 

CMND REJECT 000 NOISE 000 TRK ERR O 000 R/W VRC 000 ALU CK/MP ERR 000 NEW SUBSY XXX 

INTV REQUIRED 000 TU STAT A 000 TRK ERR 1 000 MTE/LRCR 000 REJECT TU 000 NEW SUBSY XXX 

BUS OUT CHK 000 TU STAT B 000 TRK ERR 2 000 SKEW 000 TAPE INDICATE 000 WRT TM CHK 000 

EQUIP CHK 000 7 TRACK 000 TRK ERR 3 000 EDC/CRCR 000 WRT TR VRC 000 ID BURST CHK 000 

DATA CHK 000 LOAD POINT O00 TRK ERR 4 000 ENV/ECC 000 U-PGM DET/RES 000 ST RD CHK 000 

OVERRUN 000 WRITE STATUS O00 TRK ERR 5 000 1600 BPI TU 000 LOOP W/R 000 PARTIAL REC 000 

WORD COUNT OOO FILE PROTECT O00 TRK ERR 6 000 BACKWARD 000 TU CHECK 000 EXC POST OR TM 000 

DT CNVTT 000 NOT CAPABLE 000 TRK ERR 7 000 C/P COMPARE 000 RES FOR RPQ 000 RES FOR RPQ 000 

BYTE 6 BYTE 7 BYTE 8 BYTE 9 BYTE 10 BYTE 11 

7 TRACK XXX LAMP FAIL 000 IBG DROP 000 6250 CORRECTN 000 CMD ST REJ 000 B BUS LSR/MP1 000 

WRT HD CR 000 TP BOTTOM LF O00 FEED THRU/RES 000 VEL CHG 000 RESERVED 000 SPARE 000 

DUAL DEN XXX TP BOTTOM RH 000 RESERVED 000 CBC 000 CTL ST REJ 000 XFER/LOIC 000 

NOT 1600 XXX RES-DOOR 000 EARLY BOR 000 CRC III 000 NO BOR/WTM 000 INST/HIIC 000 
DSE 000 E END/SAGC CK 000 RLC/3803-2 000 WTM/DRC 000 U-PGM ERR 000 
ERASE HD 000 SLOW BOR 000 RESERVED OOO TACH FAIL 000 D BUS PTY 000 
AIR PRES 000 SLOW END 000 RESERVED 000 RESERVED 000 RESERVED 000 
LOAD FAIL 000 VEL RETRY 000 CNTL UNIT RES 000 VEL CHK 000 BOC ALU1/MP1 000 , 

BYTE 12 BYTE 18 BYTE 19 BYTE 20 BYTE 21 } 

B BUS LSR/MP2 000 PWRCHK/AIRFLW 000 DE DR 7 000 DE DR F 000 LD BUTTON 000 

SPARE 000 RESERVED 000 DE DR 6 000 DE DRE 000 LFT REEL 000 

XFER/LOIC 000 RESERVED 000 DE DR 5 000 DE DR D 000 RHT REEL 000 

INST/HIIC 000 RESERVED 000 DE DR 4 000 DE DRC 000 TAPE PRES 000 

U-PGM ERR 000 EC OF DRV 000 DE DR 3 000 DE DR B 000 REELS LDD 000 

D BUS PTY 000 EC OF DRV 000 DE DR 2 000 DE DRA 000 LD RWD 000 

RESERVED 000 EC OF DRV 000 DE DR 1 000 DE DR 9 000 LD COMPL 000 

BOC ALU2/MP2 000 EC OF DRV 000 DE DR O 000 DE DR 8 OOO LD CHK 000 

SDR AREA DEVICE DEPENDENT COUNTERS 

NOISE 0001 WRT TR VRC 0000 EARLY BOR 0000 CRC III 0000 TEMP RDS 00000 

R/W VRC 0001 WRT TM CHK 0000 E END/SAGC CK 0000 BACKWARD 0000 TEMP WRTS 00000 

MTE/LRCR 0001 ST RD CHK 0000 SLOW BOR 0000 BUS OUT CHK 0000 SIO COUNT 00001358 

EDC/CRCR 0000 PARTIAL REC 0001 SLOW END 0000 ALU CK/MP ERR 0000 ERASE GAPS 00000 

ENV/ECC 0001 EXC POST OR TMOOOO VEL RETRY 0000 ID BURST CHK 0000 CLEAN ACTS 00009 

OVERRUN 0000 IBG DROP 0000 6250 CORRECTN 0001 NOISE RCD 00000 

SKEW 0000 FEED THRU/RES 0000 VEL CHG 0000 

C/P COMPARE 0000 RESERVED 0000 CBC 0000 


Figure 2-41. I/O Outboard Environment Summary 
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SLH Detail (PRINT) Reports 


DEVICE NUMBER: 0576 REPORT: SLH EDIT DAY YEAR JOB IDENTITY: D40BAE1 
SCP: VS 2 REL. 3 DATE: 109 82 C4F4F0C2C1C5F140 
DEVICE TYPE: 3410 
CPU MODEL: 3081XA HH MM SS.TH 
CHANNEL PATH ID: 05 oi X20015 TIME: 11 22 53.30 
1 
cc CA FL CT 
FAILING CCW O02 BBF108 44 00 1008 VOLUME SERIAL T81784 
SUBCHANNEL ID NUMBER 00010259 
K FLAGS CA US SS CT ERROR TYPE OTHER 
SCSW 84 024017 OOEEFD40 00 02 1008 
---UNIT STATUS---- SUB-CHANNEL STATUS = --3----rrrr errr SCOW PLAGS=<ss<"s9s=s2s<245<s—4=+- 
FLAG 0 FLAG 1 FLAG 2 
ATTENTION QO PGM-CTLD IRPT O CCW FORMAT O RESERVE O SUBCHANNEL ACTIV 0 
STATUS MODIFIER OQ INCORRECT LENGTH 0 PRE-FETCH CCW O SSCH FUNCTION 1 DEVICE ACTIVE 0 
CONTROL UNIT END 0 PROGRAM CHECK QO INIT STATUS QO HSCH FUNCTION O SUSPENDED 0 
BUSY QO PROTECTION CHECK 0 ADDR LIMIT QO CSCH FUNCTION O ALERT STATUS 0 
CHANNEL END QO CHAN DATA CHECK 0 SUPP SUSPEND INT 0O RESUME PENDING 0 INTERMED STATUS 0 
DEVICE END QO CHAN CTL CHECK QO ZERO COND CODE O START PENDING O PRIMARY STATUS 0 
UNIT CHECK O I/F CTL CHECK 1 EXTENDED CONTROL 1 HALT PENDING QO SECONDARY STATUS 0 
UNIT EXCEPTION QO CHAINING CHECK QO PATH NOT OPER 0 CLEAR PENDING 0O STATUS PENDING 0 


CHANNEL ERROR ANALYSIS 0 
IRB STORED BY INTERRUPT 1 
TERMINATION BY -- SELECTIVE RESET -- CODE 2 


SEQ CODE 2 - COMMAND ACCEPTED BY DEVICE BUT NO DATA TRANSFERRED 


VALIDITY OF RECORDED DATA 


COUNT INVALID 
TERMINATION CODE VALID 
SEQUENCE CODE VALID 
DEVICE STATUS INVALID 
CCW ADDRESS VALID 
DEVICE NUMBER VALID 
SENSE DATA NOT STORED 


Figure 2-42 (Part 1 of 2). SLH Detail Edit Report (370-XA only) 
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SLH Detail (PRINT) Reports 


CHANNEL EXTENDED LOGOUT 


INTERFACE CONTROL CHECK REASON CODE 


BUS IN PARITY 
TAG SEQUENCE ERROR 
IN TAG ERROR 
INTERFACE HANG CONDITION 
DISCONNECT IN 
DSE TIMEOUT 

IAE TIMEOUT 


UNIT ADDRESS 


TRANSMITTED 
RECEIVED 


UA COMPARE ERROR 


CHANNEL PATH ID: 


I/O INTERFACE 


TAG 


LINES 


OP OUT 

SEL OUT 
SUPPRESS OUT 
HOLD OUT 
ADDRESS OUT 
COMMAND OUT 
SERVICE OUT 


76 
76 
NO 


05 


OoOoOrOrFr FF 


CHANNEL DATA REGISTER: 0 


HEX 

HEADER 
0018 
0038 
0058 
0078 


DUMP OF RECORD 


23831800 
C4F4F0C2 
OOEEFD40 
42207640 
0576E3F8 


00000000 
C1c5F140 
00021008 
00000000 
F1IF7F8F4 


FoOoooo°o:”9o 


INVALID 
VALID 


OP IN 

SEL IN 
REQUEST IN 
DISCONNECT 
ADDRESS IN 
STATUS IN 
SERVICE IN 
DATA IN 


0 PARITY: 


0082109F 
O2BBF108 
00807482 
00000000 
01000000 


IN 


OO OC 0O 00 F 


YES 


11225330 
44001008 
00000000 
00000000 
01000005 


03020015 
32108003 
00000000 
00000000 
00010259 


Figure 2-42 (Part 2 of 2). SLH Detail Edit Report (370-XA only) 


Notes: 
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30810000 
00000000 
00000000 
00000000 
00000000 


40807782 
00000000 
00000000 
00000000 


82024017 
00720576 
OOF9B610 
00000000 


The SLH record is logged in 370-XA mode only. It is identified by CPU 
complex, not individual CPU serial number. Only the last 5 digits are signif- 
icant. 


The error type may be storage, key or other. If the error type is storage or key, 
a line containing the absolute address of the error is printed. 


CCW format is 0 in 24-bit addressing mode, I in 31-bit addressing mode. 


SLH Detail (PRINT) Reports 


CHANNEL PATH ID: 24 REPORT: SLH SUMMARY REPORT DATE: 113 82 
PERIOD FROM: 113 82 
NUMBER OF RECORDS: 0004 CPU MODEL: 3081XKA TO: 113 82 


CPU SERIAL: X20015 


ERROR TYPE: STORAGE 0000 


KEY 0000 

OTHER 0004 
----UNIT STATUS---- --SUB-CHANNEL STATUS-- 
ATTENTION 0000 PGM-CTLD IRPT 0000 
STATUS MODIFIER 0000 INCORRECT LENGTH 0000 
CONTROL UNIT END 0000 PROGRAM: CHECK 0000 
BUSY 0000 PROTECTION CHECK 0000 
CHANNEL END 0000 CHAN DATA CHECK 0000 
DEVICE END 0000 CHAN CTN CHECK 0000 
UNIT CHECK 0000 I/F CTL CHECK 0004 
UNIT EXCEPTION 0000 CHAINING CHECK 0000 


Figure 2-43. SLH Detail Summary Report (370-XA only) 
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Software Detail (PRINT) Reports 


DATE TIME CBU CPU 
DAY YR HH MM SS.TH SERIAL ID 
~-- RECORD ENTRY SOURCE - SOFTWARE --- TYPE SOFTWARE(SVC 13) 065 85 10 31 23 24 270044 3090 
VS 2 REL. 03 
ERRORID=SEQ00001 CPU0042 ASIDOOO1 TIME10.31.23.0 
JOBNAME *MASTER 
ABENDING PROGRAM NAME N/A BC MODE PSW AT TIME OF ERROR BC MODE PSW OF LAST RB 
NAME OF MODULE INVOLVED IEAVFREE 
NAME OF CSECT INVOLVED IEAVFREE 00000000 00000000 00000000 00000000 
FUNCTIONAL RECOVERY ROUTINE IEAVRCV 
REGS AT TIME OF ERROR 
REGS 0-7 OOFFFOOO OOCODO0O C0024680 0004C320 00A27170 00000000 OO0000D08 OO00E890 
REGS 8-15 0010B520 400B3EE6 00000000 0079FC90 0004C320 00000000 500B3FBO 00000004 


EC PSW AT TIME OF ABEND 040C1000 OOOB3FD2 


ADDITIONAL INFO: 


EC PSW FROM ESTAE RB(O FOR ESTAI) 
ADDITIONAL INFO: 


INST LENGTH CODE 02 INST LENGTH CODE 02 

INTERRUPT CODE OO00D INTERRUPT CODE 000D 

VIRT ADDR OF TRANS EXCEP OOCD5006 VIRT ADDR OF TRANS EXCEP 00CD5006 

REGS OF RB LEVEL OF ESTAE EXIT OR ZERO FOR ESTAI 

REGS 0-7 OOFFFOOO OOCODO0N C0024680 0004C320 00A27170 00000000 OO0000D08 OO00E890 
REGS 8-15 0010B520 A00B3EE6 00000000 0079FC90 0004C320 00000000 500B3FBO 00000004 


MCH INPUT INFO 
STORAGE KEY FAILURE 
REGISTERS UNPREDICTABLE 
PSW UNPREDICTABLE 


MCH FLAG BYTE 
STORAGE ADDRS ARE VALID ) 
MCK RECORD NOT RECORDED 0) 
TIME STAMP IS VALID 0 
0 
0 
0 


STORAGE IS RECONFIGURED STORAGE DATA CHECK 
RECONFIGURE STATUS AVAIL ACR REQUEST 
RECONFIGURE NOT ATTEMPTED INSTRUCTION FAILURE 

SOFT ERROR 

TIMER ERROR 
BEGINNING VIRT ADDR OF STORAGE CHECK 00000000 
ENDING VIRT ADDR OF STORAGE CHECK 00000000 
REAL STORAGE FAILING ADDRESS 00000000 


MACHINE CHECK 

PROGRAM CHECK 

RESTART KEY DEPRESSED 
TASK ISSUED SVC 13 
SYSTEM FORCED SVC 13 

SVC BY LOCKED OR SRB RTN 
TRANSLATION FAILURE 

PAGE I/O ERROR 


O TYPE 1 SVC IN CONTROL 

O ENABLED RB IN CONTROL 

Q DISABLED RTN IN CONTROL 
QO SYSTEM IN SRB MODE 


oOoOor oO 


Figure 2-44 (Part 1 of 2). Software Detail Edit Report 
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FRAME ERROR INDICATORS STORAGE ERROR INDICATORS 
O STORAGE ERROR ALREADY SET O FRAME OFFLINE(OR SCHED) 
O CHANGE INDICATOR ON O INTERCEPT 
0 STORAGE ERROR PERMANENT 


0 PERMANENT RES. STORAGE 
0 FRAME IN SQA 
) FRAME IN LSQA 
0 FRAME IS PAGE FIXED 
0 FRAME IS V=R 
TIME STAMP OF ASSOCIATED MACHINE CHECK RECORD 
DATE TIME 
DAY YR HH MM SS.TH 
000 00 00 00 00 00 
1 PREV ESTA OR FRR FAILED 0 EXIT TO CLEANUP ONLY 
OQ (E)STAI PREV IN CONTROL 0 RB OF ESTA NOT IN CONTROL 
1 IRB PRECEDED RB 0 ESTA EXIT FOR PREV ABEND 
© THIS RTN PERCOLATED TO 0 STEP ABEND REQUESTED 
LOWER LEVEL EXIT INFO 0 TASK ANCESTOR ABENDED 


REGS AND PSW UNAVAILABLE 
MCK INFO UNAVAILABLE 


040C0000 0009B5C8 


oOo oO CoO 000 CO 


oOo Oo 000 0 


») 





Software Detail (PRINT) Reports 





MEMORY ASID 


0000 
RECOVERY RETURN CODE 04 


CURRENT I/O STATUS 
I/O IS RESTORABLE 0 
I/O IS NOT RESTORABLE 0 


ADDITIONAL PROCESSING 
RECORDING REQUESTED 


VALID SPIN 


UPDATED REGS FOR RETRY 
FREE RTCA BEFORE RETRY 


DUMP CHARACTERISTICS 


NO I/O OUTSTANDING 0 
NO I/O PROCESSINGG 0 
GLOBAL LOCKS TO BE FREED 


1 DISPATCHER LOCK 

O SRM LOCK 

1 IOSCAT LOCK 

QO IOSUCB LOCK 
IOSLCH LOCK 
IOSYNCH LOCK 
NCB LOCK 
DNCB LOCK 
ACBDEBS LOCK 
ASMPAT LOCK 
SALLOC LOCK 
CMS LOCK 
LOCAL LOCK 


ADDITIONAL PROCESSING 
DUMP FLAGS 

SNAP DUMP REQUEST 
PARM LIST SUPPLIED 
STORAGE LIST SUPPLIED 


HEX DUMP OF RECORD 


HEADER 40830820 
0000 O00000D08 
0020 Cc0024680 
0040 00000000 
0060 00000000 
0080 0002000D 
OOAO O00000D08 
00CO 500B3FBO0 
OOEO OQOOQOO0000F 
0100 00000000 
0120 00010001 
0140 00000000 
0160 00000000 
0180 00000000 
O01A0 00000000 
01cO 00000000 
01EO 00000000 
0200 00000000 
0220 00000000 
0240 CT7CE 


Figure 2-44 (Part 2 of 2). 


ooo 0 0 0 00 00 00 08 


GLOBAL LOCKS TO BE FREED 
SDATA OPTIONS 
O DISPLAY NUCLEUS 0 
QO DISPLAY SQA 0 
O DISPLAY LSQA 0 
DISPLAY SWA 0 
DISPLAY GTF TRACE TABLE 0 
DISPLAY CONTROL BLOCKS 0 
DISPLAY QCB/QELS 0 
00000000 O085065F 10312324 
OO0COD0D00 00000000 00000000 
0004C320 00A27170 00000000 
0079FC90 0004C320 00000000 
00000000 040C1000 O00B3FD2 
OOCD5006 OOFFFOOO  oO0coDO000 
OCOOOE890 0010B520 400B3EE6 
00000004 00000000 00000000 
00000000 040A0001 00000042 
00000000 §=©00000000 00000000 
C9C5C1E5 C6D9C5C5 C9CS5C1E5 
00000000 00000000 00000000 
00000000 00000000 # FFFFOOO1 
00000000 00000000 O0005C7CE 
01800000 00000000 00000000 
00000000 00000000 00000000 
00000000 §=©00000000 00000000 
00000000 00000000 00000000 
00000000 00000000 00000000 


Software Detail Edit Report 


LOCKWORDS 


IOSCAT LOCKWORD 
IOSUCB LOCKWORD 
IOSLCH LOCKWORD 
IOSYNCH LOCKWORD 
NCB LOCKWORD 
DNCB LOCKWORD 
ACBDEBS LOCKWORD 
ASMPAT LOCKWORD 
ASID LOCKWORD 


00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 


LOCKWORDS 

PDATA OPTIONS 

DISPLAY SAVE AREAS 0 

DISPLAY SAVE AREA HEADER 0 

DISPLAY REGISTERS 0 

DISPLAY TASK LPA MODULES 0 

DISPLAY TASK JPA MODULES 0 

DISPLAY PSW 0 

DISPLAY USER SUBPOOLS 0 
00270044 30900000 
00000000 00000000 
OO0000D08 OOO00E890 
500B3FBO 00000004 
0002000D OOCD5006 
C0024680 0004C320 
00000000 0079FC90 
00000000 00000000 
OOOB3FD2 OOFE8DC4 
00000000 00000000 
C6D9C5C5 C9C5CI1E5 
00000000 00000000 
OOFE8FO08 80000001 
OOFF8064 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
00000000 00000000 
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DUMP 


RANGE 
RANGE 
RANGE 
RANGE 


mW N 


5CD4C1E2 
OOFFFOOO 
0010B520 
00000000 
04000000 
00A27170 
0004C320 
00000000 
00000000 
00000000 
D9C3E540 
00000000 
00010001 
00000000 
00000000 
00000000 
E2C3F1C3 
00000000 
00010042 


RANGES AREA 


FROM 

00000000 
00000000 
00000000 
00000000 


TO 

00000000 
00000000 
00000000 
00000000 


E3C5D95C 
OOCODO00 
400B3EE6 
00000000 
O0009B5C8 
00000000 
00000000 
00000000 
04980000 
00000000 
OOFE8D70 
00000000 
00000000 
00508010 
00000000 
00000000 
D9000000 
00000000 
00010005 
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Software Detail (PRINT) Reports 


DAY YEAR DAY YEAR MODEL- 0168 


SOFTWARE DATE RANGE - 051 80 TO 051 80 


SERIAL NO. 060702 


SUMMARY OF SOFTWARE ENVIRONMENT RECORDS 


TOTAL NUMBER OF RECORDS 0009 


ROUTINE CSECT NUMBER ROUTINE CSECT NUMBER ROUTINE CSECT NUMBER 
NAME NAME ENTRIES NAME NAME ENTRIES NAME NAME ENTRIES 


IEBGENER IEBGENER 005 IGXFOOBB IFCERO2 003 IGXFO003 IFCERO1 


Figure 2-45. Software Detail Summary Report 


DATE 
DAY YR 
VS 2 REL. 03 - SOFTWARE --- TYPE LOST REC SUMMARY 119 82 


NO ERRORID ASSOCIATED WITH THIS RECORD 


MISSING RECORD COUNT 095 
HEX DUMP OF RECORD 


001 


TIME 
HH MM SS.TH 
03 28 50 08 


HEADER 4F831880 00000000 0082119F 03285008 03020015 30810000 


0000 5F 


Figure 2-46. Lost Record Summary (MVS only) 
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ROUTINE CSECT NUMBER 
NAME 


NAME ENTRIES 
CPU CPU 
SERIAL ID 
020015 30 


System Initialization Detail (PRINT) Reports 


IPL RECORD EDIT AND PRINTING SECTION 


DAY YEAR HH MM SS TH 
DATE -287 86 TIME -16 51 52 17 
MODEL - 9375 CPU SERIAL NO. - 234567 
VS 2 REL. 02 


~-CHANNEL TYPE-- 
CHANNELS 0-15 


SEL SEL BLKMPX BLKMPX BLKMPX BLKMPX SEL MPX 
BLKMPX MPX UNATT UNATT UNATT UNATT UNATT UNATT 
IPL REASON CODE - DF DEFAULT -U- 
SUBSYSTEM ID - 00 SUBSYSTEM NAME - NULL 


HIGHEST STORAGE ADDRESS OOFFFFFF 
HEX DUMP OF RECORD 
HEADER 50820000 00001100 0086287F 16515217 10234567 93750000 
0000 00000000 C4C6BFCO 22333321 31000000 OOFFFFFF 00000000 


Figure 2-47. System Initialization (IPL) Detail Edit Report 


SUMMARY OF IPL RECORDS MODEL 9375 


DAY YEAR DAY YEAR CPU SERIAL 234567 
DATE RANGE FROM 287 86 TO 290 86 
NO. OF RECORDS 008 


XXXX SUBSYSTEM NAME AND NUMBER OF OCCURRENCES XXXxX 


NULL 008 PROCESSOR 000 
TAPE 000 TELEPROCESSING 000 
MICR/OCR 000 GRAPHIX/DISPLAY/AUDIO 000 
CARD/PRINT 000 IBM SYSTEM CONTROL PROGRAM 000 
DIRECT ACCESS 000 IBM PROGRAMMING PRODUCT 000 
OTHER 000 

XXXX IPL REASON CODE AND NUMBER OF OCCURRENCES XXX 

NORMAL 000 MEDIA 000 
UNKNOWN 000 OPERATIONAL 000 
USER PROGRAM 000 ENVIRONMENTAL 000 
IBM HARDWARE PROGRAMMING PROBLEM-CE/SE NOT REQUIRED 000 

IBM HARDWARE PROGRAMMING PROBLEM-CE/SE REQUIRED 000 

CE/SE HAS THE SYSTEM 000 

DEFAULT -U- 008 


INVALID IPL REASON CODE 000 
XXXXXXX END OF IPL SUMMARY XXXXXXX 


Figure 2-48. System Initialization (IPL) Detail Summary Report 
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System Termination Detail (PRINT) Reports 


EOD RECORD EDIT AND PRINTING SECTION 


DAY YEAR HH MM SS TH 
DATE -234 86 TIME -05 31 41 68 
MODEL - 3090 CPU SERIAL NO. - 270150 
VS 2 REL. 03 


HEX DUMP OF RECORD 
HEADER 80831800 00400000 0086234F 05314168 40270150 30900000 


0000 


Figure 2-49. System Termination (EOD) Detail Edit Report 


SUMMARY OF EOD RECORDS MODEL 3090 
DAY YEAR DAY YEAR CPU SERIAL 270150 
DATE RANGE FROM 219 86 TO 234 86 
NO. OF RECORDS 005 


XXXXXXX END OF EOD SUMMARY XXXXXX 


Figure 2-50. System Termination (EOD) Detail Summary Report 
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Unknown Detail (PRINT) Reports 


RECORD TYPE UNKNOWN OR UNSUPPORTED 


MODEL-9373 SERIAL NO- 010620 
--- RECORD ENTRY SOURCE - MCH 
V370 REL. 06 


DAY YEAR 
DATE- 211 86 


HH MM SS TH 


TIME- 16 45 08 59 


PROGRAM IDENTITY- CP/370 
JOB IDENTITY- 


OLD MACHINE CHECK PSW - 00 OC 00 00 OO O01 O09 OA 


HEX DUMP OF RECORD 


HEADER 10660800 00000000 0086211F 16450859 00010620 93730000 4040C3D7 61F3F7F0O 
00000000 00000000 000C0000 0001C90A 
0030 04010F3D 00030000 00000000 22000000 00000000 00000000 00000000 00000000 
0050 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
0070 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
0090 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
OOBO 00000000 00000000 00000000 00000000 00000000 00000000 00000000 0001CE10 
O0ODO 00000000 0001D2EC 4001C8F4 8001D2F0 003D0380 00000034 003D0380 003D04C8 
OOFO 070D0000 00065678 0001C3A8 OO1FA1A8 00395480 00033584 80800ECO 063D0940 
0110 FFFFFFFF 00000000 00000000 00000000 A33A33B8 00000000 00000000 00000000 
0130 00000000 00000000 00000000 00000000 CFCO0000 00000000 00580000 00000000 
0150 80000000 00000004 00000000 00000000 00000000 00000000 00000000 00000000 
0170 00000000 00000000 00000000 00000000 00000000 00000002 00000000 00000000 
0190 00000000 00000000 003D0380 0039BABO 


Figure 2-51. Unknown or Unsupported Record Detail Edit Report 


Notes: 


1. Depends upon the record type. It will be either the hex representation of the 
first byte in the record or a 3 character description of the record type. See 
Figure 10-6 on page 10-12. 


SUMMARY OF UNKNOWN OR UNSUPPORTED RECORDS 


DAY YEAR 
264 86 


DAY YEAR 


RECORD DATE RANGE 264 86 


MODEL-9373 SERIAL NO - 234567 
TOTAL NUMBER OF RECORDS=0002 
CLASSES ENCOUNTERED(MAXIMUM OF 10) 
RECORD CLASS -10 0002 


Figure 2-52. Unknown or Unsupported Record Detail Summary Report 
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Interpreting EREP Reports 


Interpreting EREP Reports 


After you have succeeded in generating a set of EREP reports, you want to look 
at them to see what they indicate about your data processing system. In many 
installations, someone looks the reports over for indications of obvious problems 
and calls the IBM Customer Engineer if a problem seems to be hardware- 
connected. 


You should become familiar with the general appearance of the reports, so you 
can tell if you are getting the right output from the EREP run; you may want to 
do some of your own problem determination, as well. 


The examples of EREP reports earlier in this chapter are meant to give you a 
general idea of what each one is supposed to look like, but there is no way to 
show you all the possible variations caused by different devices and different 
parameter combinations. 


For that kind of information, you need the maintenance documentation for the 
product. Some IBM products provide detailed directions on how to interpret the 
information in EREP reports; see the bibliographies included in some of the 
product sections in Part 4. 


This book can also help you distinguish among the various record types and the 
devices or products each type is associated with. Figure 12-2 on page 12-4 shows 
the records generated by the different product groups, and the reports EREP 
produces for those records. Chapter 10, “Error Records for EREP” includes 
brief explanations of why the various records are generated, along with their 
formats. 


For detailed information about the significance of particular fields in the EREP 
reports, you must look in the maintenance documentation for the devices in your 
installation. 


Some observations about how EREP arrives at some of the information in the 
reports follow. 


How EREP Assigns Letters to CPUs 
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In nearly all its reports, EREP identifies each processor by a single letter of the 
alphabet. It assigns the letter identifiers separately for each report, based on the 
processors’ model and serial numbers and when it encounters them. If your 
EREP controls include SHARE or CONTROLLER statements, EREP assigns 
letters to the processors you specify on those statements before reverting to a 
default method. You can take advantage of this sequence to force EREP to 
assign specific letters to specific processors, and to use the same letter for each 
processor in all the EREP reports. 


J 


C 





Interpreting EREP Reports 


Sequence of Letter Assignments 


As it processes records for a requested report, EREP builds a table of CPU letter 
assignments, starting with those CPUs that appear on SHARE or CON- 
TROLLER statements. 


EREP assigns letters to processors (CPUs) appearing on SHARE or CON- 
TROLLER statements as follows: 


1. It examines the first entry on every statement, assigning the next letter of the 
alphabet to each new CPU model or serial number it encounters. 


2. After assigning letters to the CPUs in all the first entries, it examines the rest 
of the entries on each statement in turn, assigning the next letter to each new 
CPU serial number it finds. 


3. After completing these assignments, EREP assigns letters to any processors it 
encounters in the input data that are not specified on SHARE or CON- 
TROLLER statements, using its default method. 


The default method is to assign letters to processors in the order in which they 
occur in the input data. These letter assignments can change from one report to 
the next, if the reports use different error records. 


The following example illustrates EREP’s letter assignments for CPUs that appear 
on SHARE or CONTROLLER statements. 


SHARE=(000001.120,000002.120,000006.120) 
SHARE= (000003.130,000004.130) 
SHARE=(000005.140,000003.140) 


Assume that EREP also encounters CPU serial number 000007 in the input data. 
EREP assigns letter identifiers to all of these processors as follows: 


Letter CPU 
Identifier Serial Number 
A 000001 

B 000003 

C 000005 

D 000002 

E 000006 

F 000004 

G 000007 
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Interpreting EREP Reports 


Forcing CPU Letter Assignments 


All of these letter assignments could be different for the next report, because 
EREP reassigns letters to CPUs for each report. You can, however, force EREP 
to assign the same letter to the same CPU for every report? by using SHARE 
statements as follows:4 


3 
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Set up SHARE statements for each of your processors, in which the first 
entry is for the actual processor and the second entry contains a dummy CPU 
serial number. 


Make one of these SHARE statements the first one for each group associated 
with the real processor serial number. 


When EREP encounters the SHARE statements while assigning CPU identi- 
fiers, it will assign the letter A to the processor represented by the first entry 
on the first dummy SHARE statement, B to the first entry on the next 
dummy SHARE statement, and so on. It will eventually assign a letter to the 
dummy serial number, too, but the identifier will not appear on the report 
because there will be no records associated with the dummy processor. 


If you include these SHARE statements for every EREP run, every report 
except the Event History will identify the same processors the same way. 


Except for the Event History, which cannot use SHARE or CONTROLLER state- 
ments because it must order the records chronologically. 


Even if you don’t need SHARE statements to identify shared devices. 


2 


C 


A Planning Checklist 


A Planning Checklist 


Having read the first two chapters of the EREP User’s Guide, you are now ready 
to start setting up an EREP run. The following checklist contains the questions 
you need to ask yourself as you prepare to set up EREP for your installation. 
Where relevant, the questions are followed by pointers to information elsewhere. in 
this book that can help you answer “Yes.” 


1. Report content and sequence agreed upon with CE? 


2. Working copy of LOGREC/SYSREC on disk? See “Managing Error 
Data” on page 3-1. 


3. History data set up to date and usable? See “Managing Error Data” on 
page 3-1. 


4. DASDID statements ready for System Exception reports? See “DASDID 
Control Statement” on page 8-7. 


__. a. Tnial run for TOURIST output? 
___ b. Configuration chart on TOURIST agree with the installation’s 
actual configuration? 


5. LIMIT statements ready for System Exception reports? See “LIMIT 
Control Statement” in Part 3, and the LIMIT Control statement sub- 
sections under Chapter 20, “Processors (CPUs),” “34XX Tape Devices,” 
and “33XX DASD” in Part 4. 


__a. Trial run for syntax check? 


6. SHARE/CONTROLLER statements ready? See “SHARE Control 
Statement” on page 8-18 and “CONTROLLER Control Statement” on 
page 8-4. 


7. Should the region/partition size be increased? See “VSE Storage 
Requirements” on page 4-16 or “MVS Storage Requirements” on 
page 4-34. 


8. Are you setting up EREP to run automatically? 


a. Fora VSE EREP run, set up a job to be submitted via ICCF 
b. For an MVS EREP run, set up a job to be submitted via TSO 
c. Fora VM EREP run, set up CMS EXECs 


a. EREP run schedule ready for operator? 
b. Running EREP automatically off timer? 
c. Which reports? 

d. Which other functions? 

e. In what order? 

f. How often? 


See “Automating the Running of EREP” on page 3-7. 
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A Planning Checklist 


9. Have you set up a procedure to get an EREP report on demand? See 
“Modifying Your EREP Run” on page 3-8. 


10. Report distribution set up? 
a. CE 

b. PSR 

c. System programmer 
d 


Other 


You must, of course, review your EREP plan whenever your configuration 
changes, and ask these questions: 


e Does the new configuration require new SHARE, DASDID, or LIMIT con- 
trols? 


e Does it mean getting an additional report or set of reports? 
e Does it require a new history tape because of changed device addresses? 


The specifics of EREP support for new products are in Part 4, “Product- 
Dependent Information.” ) 
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Part 2. Setting Up and Running EREP 


How to Use Part 2 


This part of the User’s Guide contains the information you need to set up an 
EREP run for your installation. Most of the information is grouped according to 
operating system control program (SCP) and includes the following: 


e An annotated master example of the EREP and system controls that make up 
a typical EREP run 


e A description of the system data sets and controls required for running EREP 
under the SCP 


e Other specific coding and storage considerations for running EREP. 


Before and after this SCP-specific information, Part 2 presents several more 
general topics that are important to the process of running EREP: 


e Suggestions for managing and maintaining your error-record data 
e Suggestions for automating the running of EREP 

e Suggested ways to modify EREP controls for a particular run 

e Suggestions for correcting coding problems. 

Use the Section Table of Contents to find things in Part 2. 


If you need more detailed information about the syntax and coding of EREP 
parameters and control statements, it is in Part 3. 


Part 2. Setting Up and Running EREP 


If you want further information about your SCP or specific devices and products, , 
see Part 4. J 


For examples of the EREP reports, see Chapter 2, “EREP Reports”; there are 
also a few in Part 4. 
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Chapter 3. Setting Up EREP 


Before you start setting up an EREP run for your installation, there are a few 
general topics relating to the running of EREP that you might find helpful. Man- 
aging the error data, automating your EREP run, and modifying an EREP run, 
are all things you should consider as you prepare the system and EREP controls 
for your EREP run. 


Managing Error Data 


If EREP is to be useful and helpful, it must have “good” data to edit and print. 
You must manage your ERDS and other error data sets so that the records they 
contain truly reflect the state of your installation’s hardware and operating 
system. 


Managing error data for EREP, like managing any data base, has several aspects. 
Two of particular importance to EREP are: 


e The integrity of the data base: making sure the input to EREP includes all the 
records produced, but no duplicates. 


e The consistency of input to a given EREP run: making sure all the reports in 
a run use the same records. 


In addition to these is the matter of saving the records in case of emergency. 
EREP includes a special routine that takes care of this situation; see “Clearing the 
ERDS in an Emergency” on page 3-4. 


Maintaining ERDS Data Integrity 


When your system’s ERDS is almost full, the recording routines sense it and issue 
a message to the operator. The operator is supposed to run EREP at that point, 
to clear the ERDS. Usually, this EREP run requests a System Summary; it 
always includes ACC=Y and ZERO=Y, to write the contents of the ERDS to 
another data set and to clear the ERDS so the recording routines can write more 
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records to it. Although the procedure is quite straightforward, there are several 
potential problems: ») 


1. In an MVS system when you request a System Summary,! EREP forces the 
system to dump the statistical counters from storage and from buffered-log 
devices to the ERDS in the form of OBR and MDR records.? If the operator 
delays the running of EREP until the ERDS is completely full, there is no 
room for the additional records; the statistical data is lost. In such a situ- 
ation, it is better to use IFCOFFLD; “Clearing the ERDS in an Emergency” 
on page 3-4 tells you how to do this. 


2. If one or more I/O devices are not able to complete the transfer of data from 
buffered-log when requested by EREP, then the EREP job may not complete, 
and reports may not be produced. In such a situation IFCOFFLD may be 
used to transfer the contents of the ERDS to the history data set and then the 
history data set may be used to produce EREP reports. 


3. Ifthe step or job fails for any reason and you subsequently rerun it, you 
could duplicate some of the records already on the output data set. 


Merely knowing about these problems should help you avoid them; the ways to 
avoid them differ slightly from one operating system to another. The following 
sections include some suggestions to help ensure the integrity of EREP’s input 
data. 


Maintaining Consistency of Input across Reports J 


Using EREP properly gives you the ability to monitor and track potential failures 
in your installation’s hardware and software, and thus to catch them before they 
cause serious damage. 


Part of using EREP properly is running it regularly. In a large MVS installation, 
this means daily; in a smaller VSE installation, weekly. The main thing is to set 
EREP up so it can be run easily. “Automating the Running of EREP” on 

page 3-8 addresses this task in a general way. Your installation’s policies and the 
operating system you want to run EREP under determine how automatic the 
process of running EREP can be. 


A secondary consideration is the kind of data each run processes. The ERDS is a 
dynamic data set; it is constantly being updated by the system’s recording rou- 
tines, even while you are running EREP against it. When the ERDS is the source 
of input records for EREP, especially in a multi-step run, the data on the ERDS 
can change from one report to another. 


If you want to compare the contents of several reports, you need consistent input 


for each report. The only way to get it is to create, at the beginning of your 
EREP run, a static working data set that can be used as input for all the subse- 


l And some other reports as well; see “Statistical Data on the ERDS” on page 3-7. 


2 A VSE system writes such statistical records only when the operator issues the ROD J 
(record on demand) command. 
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Emergency Offload of the ERDS - IFCOFFLD 


quent reports. Then, every report draws records from the same data base. See 
“Creating a Working Copy of the ERDS” on page 3-5. 


Clearing the ERDS in an Emergency 


IFCOFFLD under VSE 


If the ERDS is filling up too quickly, so that it could overflow, you can use the 
special EREP procedure named IFCOFFLD to offload the records to another 
data set as quickly as possible. 


IFCOFFLD does essentially the same thing a normal ERDS offload procedure 
does: it produces a System Summary using the records on the ERDS, then copies 
the records to an output data set and clears the ERDS. The only difference 
between the two procedures is that IFCOFFLD does not cause the dumping of 
statistical data to the ERDS prior to reading records for the System Summary. 
This difference is significant, because it prevents the loss of statistical data. It 
also saves time. 


IFCOFFLD preserves the data on the ERDS and gives you a summary report 
that can help you find the problem that caused the ERDS to fill up. 


Note: Because IFCOFFLD does not dump any statistical data to the ERDS, you 
should not use it to offload the ERDS under normal conditions; it is meant 
for emergency use only. 


IFCOFFLD is for VSE and MVS systems; in a VM system, the records in the 
error-recording area can only be offloaded by a normal EREP run that includes 
ACC=Y and ZERO=Y. It is wise to set up a separate EXEC for the operator 
to run when the page-full message appears on the console. The EXEC should 
duplicate the processing that IFCOFFLD does. See “Entering CPEREP 
Operands” on page 9-8 for more about running EREP under VM. 


If you have to offload SYSREC in an emergency, use the following JCS: 


// TLBL  HISTOT 

// ASSGN SYS009,TAPE 
// EXEC  IFCOFFLD 

f* 

/& 


This job will do the following: 


@ Generate a System Summary report without dumping the buffered and in- 
storage statistical data to SYSREC 


@ Copy the records from SYSREC to the output data set (SYS009) 

e Zero out SYSREC. 

It would be an good idea to assign your regular permanent EREP history data set 
to SYSO009 for IFCOFFLD. It would be an excellent idea to set up an 


IFCOFFLD procedure to be started from the console as needed. See “Auto- 
mating the Running of EREP” on page 3-7. 
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IFCOFFLD under MVS ) 


If you have to clear LOGREC in an emergency, use the following JCL: 


/ /OFFLD JOB accounting/programmer information 

//STEPI1 EXEC PGM=IFCOFFLD 

//SERLOG DD DSN=SYS1.LOGREC,DISP=OLD 

//ACCDEV DD UNIT=unit,DSN=name,DISP=(status,disposition), 
// DCB= (RECFM=VB,BLKSIZE=size) 

//TOURIST DD SYSOUT=A,DCB=BLKSIZE=133 

//EREPPT DD SYSOUT=A,DCB=BLKSIZE=133 

//SYSIN DD DUMMY 

7* 


This job will do the following: 


e Generate a System Summary without dumping the buffered and in-storage 
statistical data to LOGREC 


e Copy the records from LOGREC to the ACCDEV data set 
e Zero out LOGREC. 
Where to Put the Offloaded Records 


No values appear in the preceding example for the parameters on the ACCDEV 

DD statement because you have some choices about which data set to use. You 

can set up the emergency offload job so it writes the LOGREC records to a new 
data set or to an existing data set, depending on how you want to handle the J 
input to your regular EREP run. 


If you have to offload LOGREC in an emergency, you certainly want to include 
those records in the next regular EREP run, so you can see what caused 
LOGREC to fill up so quickly. You can include the offloaded records one of at 
least two ways: 


1. Concatenate the data set from IFCOFFLD to the ACCIN DD statement in 
all but the first and last steps of the EREP run. 


2. Offload LOGREC directly to the working data set itself, and then add any 
more records from LOGREC to that data set 1n the first step of the EREP 
run. 


Each of these alternatives has advantages and disadvantages. 


Concatenating the IFCOFFLD data set to the ACCIN DD statements is straight- 
forward, but not ideal for performance, as EREP would be opening and trying to 
read from an empty data set most of the time. 


Using the same data set for both functions is the most efficient, but it involves an 

additional step in the regular EREP run: you must, after deleting the working 

data set, immediately create it again so it is available for IFCOFFLD. The first 

step in the regular EREP run would modify the existing data set when offloading 

LOGREC to it, instead of creating it (DISP=(MOD,PASS) instead of J 
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DISP =(NEW,PASS)). You would probably want to use a utility, such as 
IEFBR14, to recreate the working data set after deleting it. 


Either one of these alternatives lends itself well to the automated EREP; in both 
cases, if IFCOFFLD runs, the records are included in the next EREP run without 
anyone having to do anything about it. 


When you have decided what you want to do about this question, you can set up 
IFCOFFLD in a cataloged procedure that can be started from the operator’s 
console as needed. See “Automating the Running of EREP” on page 3-7. 


Creating a Working Copy of the ERDS 


The easiest way to ensure the integrity of the data on your ERDS is to make a 
working copy of the data set either before running any EREP reports or as a 
byproduct of the first report. 


If you copy the records from the ERDS to another data set and then run your 
EREP reports using the working data set as the input source, you accomplish 
three things: 


1. Protect the record data from being changed or damaged while you are 
running the EREP reports. 


2. Avoid repeated offloading of statistical counters, something that is unneces- 
sary and can be costly in terms of both time and storage. 


3. Guarantee that all the reports in a given run use the same data base, making 
them useful for comparison. 


If you run EREP regularly and frequently, making a working copy of the ERDS 
also makes sure that the ERDS is cleared regularly and frequently — a good prac- 
tice. 


The three sample EREP runs later in this section all copy the records on the 
ERDS to a working data set in their first step. 


See “Transferring Error Data to Another Data Set” for some data-integrity con- 
siderations. In addition, you should consider the possibility of IFCOFFLD 
having copied the contents of the ERDS prior to the regular EREP run. See 
“Clearing the ERDS in an Emergency” on page 3-3. 


Transferring Error Data to Another Data Set 


In several situations described here, you are copying records from one data set to 
another — with or without requesting EREP reports at the same time. 


Whenever you offload data from a data set, you run the risk of losing or dupli- 
cating or otherwise ruining the data in the process. In the sample procedures in 
the next chapter, the error records are copied twice: in the first step, from the 
ERDS to a working data set; and in the next-to-last step, from the working data 
set to the “permanent” history data set. 
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In both steps, the potential for ruining the data exists. If the step fails for some 
reason and then is rerun, and the output data set is being added to, the result is 
duplicate records on the output data set. If the step does not fail, but no records 
are copied to the output data set, subsequent steps could be using an empty input 
data set for the EREP reports. There are many possibilities, all of which you 
want to anticipate and prevent. 


You can prevent even the most remote of these problems by including safeguards 
in your EREP setup. The sample procedures in the next chapter do not show 
such safeguards because there are many to choose from. As the most obvious 
instances: 


e Use the appropriate parameters (COND, for MVS) or control statements 
(IF . . . GOTO, for newer VSE systems) to prevent execution of subsequent 
steps if the offloading step fails. 


e Add control statements (SSYSUDUMP, for MVS) to request a dump in case 
the offloading step fails. 


e Separate the generation of reports like System Exception from the copying of 
records. 


Statistical Data on the ERDS 
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The MVS systems write statistical and usage data to LOGREC whenever you 
request certain reports using the LOGREC data as input, so as to give you the 
very latest information about your I/O devices. VSE systems do the same thing 
when the operator issues the ROD (record on demand) command before running 
an EREP report. The data comes from counters associated with the devices and 
located either in buffers or in storage, depending on the device; the operating 
system dumps it to the ERDS in the form of MDR and OBR records. 


These are the reports for which EREP forces the MVS systems to dump the 
counter data: 


System Summary 

System Exception series 

Threshold Summary 

Trends report 

Any report for which you iuave specified a device type (DEV) or ZERO=Y. 


Depending on your situation and needs, you may or may not want to have statis- 
tical data records added to your ERDS whenever you run these reports. 


If you are running EREP as a series of steps that request one report after another, 
the repeated dumping of the statistical data is costly of I/O overhead and proc- 
essing time. And the data is of little practical value because it is collected over so 
short a time. A System Exception report step, for example, can fail for lack of 
storage because EREP is trying to process so many statistical records. 
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The addition of statistical data can also affect the consistency of the data used in 
a series of reports — one of the main arguments for first creating a working copy 
of the ERDS. 


If you need to see the latest usage statistics for an I/O device, you can do so by 
running a separate detail PRINT report and specifying the device type (DEV 
parameter). 


The situation is not so hard to manage in a VSE installation, because the operator 
can directly control the dumping of statistical counters to SYSREC. However, 
semi-automatic use of the ROD command can lead to the same inefficiencies and 
inconsistencies described for the other systems. 


Automating the Running of EREP 


For EREP to be most helpful, it should be run regularly and frequently. To save 
time and avoid mistakes, you can set up a procedure or series of jobs or EXECs, 
depending on the operating system, that can be started by the operator or auto- 
matically off a timer. 


The sample EREP runs in the next chapter lend themselves to such automation 
because they cover, in general, all the kinds of reports you would want to see 
from a normal EREP run. Simply add the system controls needed to make one 
into a cataloged procedure (VSE and MVS) or a series of EXECs (VM), and it 
can be your basic EREP setup. 


If yours is a VSE installation, you can set up two procedures to be run weekly — 
one for the first run of the month, and the other for subsequent weeks — that will 
create and update a monthly history tape. The operator can choose and run the 

appropriate procedure once a week. 


For an MVS installation, the EREP runs can be in cataloged procedures, to be 
started by the operator or by a timer at set intervals. Ideally, you would create 
several procedures to cover various situations. 


Also for MVS installations, the reports themselves can be sent to an output device 
other than a printer: to a TSO terminal, for example, for online viewing. 


Under VM, you can create the series of EXECs illustrated in the sample run and 
make the whole series into a single EXEC to be run from the console or off a 
timer; or you can name each of the EXECs (EXEC SYSUM, EXEC 37XX, and 
so on) and run each report separately. 
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Modifying Your EREP Run a 
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One of the benefits of setting up a procedure or EXEC to run EREP from the 
console 1s the fact that such online procedures are easy to modify if necessary. 
However, it would be even better to set up separate, smaller procedures to deal 
with the various situations that might call for a single EREP report at a time. 


e The emergency of the overflowing ERDS is an extreme example of such a 
situation, and IFCOFFLD is the specific solution to that particular problem. 
Remember that IFCOFFLD should be ready to start from the console at any 
time. 


e If one of the general-purpose reports reveals a problem with a particular 
product or group of devices, you might need to get detailed information 
about the device type or the particular error type, in order to isolate the 
problem. It is easy to select the right report if you have named your series of 
procedures for the reports or devices involved. 


In a variation of this, you could set up your usual EREP run to focus on 
summary data, including only Detail Summaries of specific device and record 
types besides the more general reports. If a problem shows up, you can then 
run Detail Edit reports for the suspect devices to find the exact cause. For 
faster access to the detail edit information, spool the EREPPT data set toa 
display device instead of the printer. 


e Similarly, if any report is accompanied by an EREP message about the input J 
record(s), you might want to rerun EREP using the special parameter that il 
prints out the records in hexadecimal. A procedure that requests an Event 
History and includes a symbolic name for the DEBUG=(17) option would let 
you see the record in question almost immediately. (See “The EREP 
DEBUG Parameter” in Part 3.) 


In any of these situations, you could modify one of the steps in your procedure or 
EXEC and run the whole procedure again. Or you can separate out the steps you 
might need, set them up as individual procedures or EXECs, and have them ready 
to run as needed. Either way, you will be using EREP to the best advantage. 


Chapter 4. Running EREP 


On the following pages are examples of EREP runs for each of the 8/370 oper- 
ating systems. Each example has been tested using actual records; if you fill in 
the correct information for your installation, the example for your operating 
system should run as coded. 


All three examples include the same series of reports: the reports considered to be 
generally most useful for a typical S/370 installation. Furthermore, all three 
examples request the reports in a particular order: the order that allows for cre- 
ation of a working copy of the ERDS at the beginning and for the updating of a 
permanent history tape at the end. 


The examples include notes that explain what the various data sets and controls 
are for, and point to more detailed information elsewhere in the book. These 
notes should not be included if you run the examples; they are not correct job 
control language comments. 


e The master example for VSE systems is under “Running EREP under VSE” 
on page 4-2. 


e The master example for MVS systems is under “Running EREP under MVS” 
on page 4-20. 


e The master example for VM systems is under “Running EREP under VM” on 
page 4-38. 


Note: Make sure you know which level of EREP is installed on your operating 
system; sometimes new EREP support and SCP support do not match, so 
you might not be able to use all the EREP features. 


Following each example of EREP code is a detailed explanation of the system 


controls needed to run EREP under the operating system, and notes specific to 
the system. 
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Running EREP under VSE 


The History Dataset 
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All of the EREP parameters are described in detail in Chapter 7, “EREP 
Parameters”; the EREP control statements in Chapter 8, “EREP Control 
Statements.” 


You should always create a history data set before running your EREP reports. 
This insures consistency across the reports. 


The operating system adds records to the ERDS continually. If you run your 
reports against the ERDS (HIST =N) then the set of records used by the first 
report is not the same as the set used by the next report since records could have 
been added while the report was running. By the time the last report is run the 
set of records may be quite different. 


By creating a history data set and then running all of the reports against that data 
set you insure that all of the reports are using the same set of records. 


The JCS on pages 4-3 through 4-12 shows a VSE job with several steps. The first 
step creates a history data set which is used in the remainder of the steps. This is 
only an example. You must decide which reports are relevent to your installation, 
what order they should be generated in and how often they should be run. 
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Create a History Dataset 


Copy SYSREC to a tape data set 


Copy SYSREC 


Note: The operator must mount a scratch tape for use in creating the working 
history tape, and must issue the ROD command to force the recording of 
statistical data on SYSREC before EREP begins copying the records. 


// JOB EREPJOB 


// TLBL HISTOT 


// PAUSE ASSIGN SYSOO9 TO A SCRATCH TAPE 
// PAUSE ISSUE ROD COMMAND 


// ASSGN SYSOO1,cuu 


// DLBL IJSYSO1 
// EXTENT SYSOO1,xxx ... 


// EXEC IFCEREP1,SIZE=AUTO 


PRINT=NO 
ACC=Y 


ZERO=N 


J* 


// MTC REW,SYSO09 


Creates the tape label for the output (ACCDEV) data 
set. 


Instructions to the operator. 


Defines the DIRECTWK data set. Logical units 
SYSLST (for report and message output) and SYSREC, 
the ERDS, are assigned at IPL. 


Creates the disk label for DIRECTWK. Required for 
disk data sets. SYS001 must be a single extent. 


Partition size must be large enough to accommodate 
EREP and a sort table as indicated by TABSIZE. 
EREP parameters and control statements are entered as 
instream data. 


Want no printed reports yet. 
Copying the records from SYSREC to SYS009. 


Want to preserve SYSREC so it can be merged with the 
monthly history tape in the job on page 4-13. 


End of instream data. 


Rewind the ACCDEV (now history) tape. 
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System Summary (VSE) 


System Summary Report 


Generate a System Summary report from the records on the working history data 


set. 


// TLBL HISTINT 


// ASSGN SYS008,SYS009 


// ASSGN SYSO09,UA 


// EXEC IFCEREP1,SIZE=AUTO 


SYSUM 
ACC=N 


TABSIZE=50K 


ENDPARM 
SHARE 
/* 


// MTC REW,SYSO08 
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Creates a tape label for the input history data set 
(ACCIN). 


Assigns the ACCDEV data set to the input (ACCIN) 
logical unit. 


Releases the logical unit used for ACCDEV. 


Partition size must be large enough to accomodate 
EREP and a sort table. You may encounter storage 
problems if you code SIZE=AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requests the System Summary. 
Want to keep the records in the working data set. 


The default value for TABSIZE is 4K; judge the need 
for a larger sort table by the number of records on 
SYSREC and the kind of report being requested. 


End of parameters; control statements follow. 
For I/O devices shared between processors. 
End of instream data. 


Rewind the tape holding the working history data set. 


Cc System Exception Reports 


System Exception Reports (VSE) 


Generate the series of System Exception reports for processors, channels, and 
DASD and tape subsystems: 


A System Error Summary in two parts: 

1. JPL/restarts, machine and channel checks 

2. DASD and tape I/O errors across processors. 

A Subsystem Exception report for each processor 

A Subsystem Exception report on channel failures, one for each processor 
A Subsystem Exception report on DASD failures 

A Subsystem Exception report on tape failures 

A series of detailed summaries for DASD presenting data by symptom code, 
storage control unit, string, and volume 

A series of detailed summaries for 34XX tape devices presenting permanent 
and temporary errors by CUA/device number and volume. 


// EXEC IFCEREP1,SIZE=AUTO Partition size must be large enough to accomodate 


SYSEXN 


HIST 


ACC=N 


TABSIZE=100K 


ENDPARM 
DASDID 
LIMIT 
SHARE 

/* 


// MTC REW,SYSO08 


EREP and a sort table. You may encounter storage 
problems if you code SIZE=AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requests the System Exception report series. 


The input records are on the working history data set, 
rather than SYSREC. 


Want to keep them there; the same records are being 
used for all the reports. 


The System Exception series requires a larger sort table 
than other reports; see “VSE Storage Requirements” on 
page 4-16. 


End of parameters; control statements follow. 
For DASD without physical IDs. 

Limiting the number of records in the report. 
For tape drives shared between processors. 
End of instream data. 


Rewind the tape holding the history data set. 
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Detail Reports (VSE) 


MCH and CCH Detail Reports 


Print Detail Edits and Summaries of all machine and channel checks. 


// EXEC IFCEREP1,SIZE=AUTO 


PRINT=PS 


TYPE=MC 


HIST 
ACC=N 


TABSIZE=50K 


yp 


// MTC REW,SYSO08 
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Partition size must be large enough to accomodate 
EREP and a sort table. You may encounter storage 
problems if you code SIZE=AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requesting Detail Edits and Summaries of the input 
records. 


Selecting the records by type: 


M MCH 
C CCH 


Input records are in the history data set. 
Leave them there. 


Default is 4K; not enough for detail processing of spe- 
cific record types. 


End of instream data. 


Rewind the tape holding the history data set. 


J 


C Threshold Summary 


A summary of tape I/O errors: 


@ all permanent errors 


Threshold Summary (VSE) 


® temporary errors that exceed | read or 15 writes. 


Includes records from 3410, 3420, and 8809 devices. 


// EXEC IFCEREP1,SIZE=AUTO 


THRESHOLD=(001,015) 
HIST 

ACC=N 

TABSIZE=50K 
ENDPARM 

SHARE 


“ee a 


// MTC REW,SYSO08 


Partition size must be large enough to accomodate 
EREP and a sort table. You may encounter storage 
problems if you code SIZE=AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requesting a Threshold Summary. 

Input records are in the history data set. 
Leave them there. 

Default is 4K. 

End of parameters; control statements follow. 
For devices shared between processors. 

End of instream data. 


Rewind the tape holding the history data set. 
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Detail Reports (VSE) 


Detail Reports for Communications Devices 


Print Detail Summaries of all errors for 3704, 3705 and 3725 communications 
controllers. 


// EXEC IFCEREP1,SIZE=AUTO Partition size must be large enough to accomodate 


PRINT=SU 


TYPE=OT 


DEV=(3704,3705,3725) 
HIST 

ACC=N 

TABSIZE=50K 

ENDPARM 

SHARE... 

/* 


// MTC REW,SYSO08 
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EREP and a sort table. You may encounter storage 
problems if you code SIZE=AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requesting only Detail Summaries. 


Selecting the records by type: 


O OBR 
T MDR 


Selecting by device type; the communications controllers. 
Input records are in the history data set. 

Leave them there. 

Default is 4K. 

End of parameters; control statements follow. 

For devices shared between processors. 

End of instream data. 


Rewind the tape holding the history data set. 


Detail Summaries for I/O Errors 


Detail Reports (VSE) 


Print Detail Summaries of all I/O errors not already covered in the preceding 


reports. 


// EXEC IFCEREP1,SIZE=AUTO 


PRINT=SU 


TYPE=DOTH 


DEV= (N34XX,N3704,N3705,N3725) 


HIST 

ACC=N 

TABS IZE=50K 
ENDPARM 
SHARE 

/* 


// MTC REW,SYSO08 


Partition size must be large enough to accomodate 
EREP and a sort table. You may encounter storage 
problems if you code SIZE=AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requesting only Detail Summaries. 


Selecting the records by type: 


D DDR 
O OBR 
T MDR 
H MIH 


Selecting by device type; excluding those already 
covered. Note the absence of N33XX; EREP does not 
produce detail summaries for 33XX DASD anyway, so 
they need not be excluded. 


Input records are in the history data set. 
Leave them there. 

Default is 4K. 

End of parameters; control statements follow. 
For devices shared between processors. 

End of instream data. 


Rewind the tape holding the history data set. 
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Detail Reports (VSE) 


Detail Reports for Software Records 


Print Detail Edits and Summaries of all software and operational records. 


// EXEC IFCEREP1,SIZE=AUTO 


PRINT=PS 


TYPE=SIE 


HIST 

ACC=N 
TABSIZE=50K 
/* 


// MTC REW,SYSO08 
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Partition size must be large enough to accomodate 
EREP and a sort table. You may encounter storage 
problems if you code SIZE= AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requesting both Detail Edits and Summaries. 


Selecting the records by type: 


S SIE 
I IPL 
E EOD (Termination) 


Input records are in the history data set. 
Leave them there. 

Default is 4K. 

End of instream data. 


Rewind the tape holding the history data set. 


Event History Report 


Event History (VSE) 


One-line abstracts of all records, in chronological order. 


// EXEC IFCEREP1,SIZE=AUTO 


EVENT 


HIST 
ACC=N 
TABSIZE=50K 


f * 


// MTC RUN,SYSOO08 


Partition size must be large enough to accomodate 
EREP and a sort table. You may encounter storage 
problems if you code SIZE= AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requesting an Event History. Note the absence of 
selection parameters; the report is to include every 
record. 


Input records are in the history data set. 
Leave them there. 
Default is 4K. 


End of instream data. Event History uses no control 
statements. 


Rewind and unload the tape holding the history data set. 
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Update the History Tape (VSE) 


Update the History Tape 


Copy the records on the input history tape (SYS008) to the permanent history 
tape (SYS009, as EREP.HIST.TAPE) either creating or updating it. 


// TLBL HISTOT, 'EREP.HIST.TAPE' ,nnn 
// TLBL HISTINT, 'EREP.HIST.TAPE' ,nnn 


// PAUSE MOUNT SCRATCH TAPE AND 
ASSGN SYSO09 


// PAUSE MOUNT EREP.HISTORY.TAPE 
AND ASSGN SYSO0O08 


// EXEC IFCEREP1,SIZE=AUTO 


PRINT=NO 


MERGE 


ACC=Y 
ZERO=Y 
/* 


// MTC REW,SYSO009 


// MTC RUN SYSO08 
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The output (ACCDEV) data set. 
The input (ACCIN) data set. 


Instructions for the operator; assigning the ACCDEV 
logical unit. 


Instructions for the operator; assigning the ACCIN 
logical unit. 


Partition size must be large enough to accomodate 
EREP and a sort table. You may encounter storage 
problems if you code SIZE= AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requesting no report output. 


Merge the records from the old history data set and 
SYSREC, which contains the latest data because it was 
updated while the first 8 steps were being run. 


Write the combined records to the ACCDEV tape. 
Clear SYSREC. 
End of instream data. 


Rewind the ACCDEV tape; it is the input for the final 
step. 


Rewind and unload the old history (ACCIN) tape. 


Trends Report (VSE) 


Trends Report 


Print a Trends report covering the last 30 days of records from the newly updated 


history tape. 


// TLBL HISTINT, 'EREP.HIST.TAPE' ,nnn 
// ASSGN SYS008,SYS009 


// EXEC IFCEREP1,SIZE=AUTO 


TRENDS 


HIST 


ACC=N 
TABSIZE=50K 
ENDPARM 
SHARE. 

/* 


// MTC RUN,SYSOO8 


/& 


Defining the former ACCDEV data set as ACCIN; the 
updated history tape is now being used as input. 


Partition size must be large enough to accomodate 
EREP and a sort table. You may encounter storage 
problems if you code SIZE= AUTO and your partition 
is not large enough. See “VSE Storage Requirements” 
on page 4-16 before coding this parameter. 


Requesting the Trends report. Without the DATE 
parameter, Trends uses the last 30 days of records. 


Input records are still in a history data set rather than 
SYSREC. 


Leave them there. 

Default is 4K. 

End of parameters; control statements follow. 
For devices shared between processors. 

End of instream data. 


Rewind and unload the monthly history tape. 
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JCS for VSE 


VSE System Controls 
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In addition to the parameters and controls EREP needs to process records and 
produce reports, VSE requires system controls that create the interface between 
EREP and the operating system’s data management functions. You provide these 
as part of the EREP run, as follows: 


[/ JOB JOBNAME 
This statement notifies the operating system of the EREP job. 


// TLBL HISTINT or // DLBL HISTIND 
(// EXTENT SYS008,xxxx,1,,xxxx,x, for DASD) 
Defines the tape (TLBL) or DASD (DLBL) input history data set. 


The EXTENT statement is only required if the history data set resides on 
DASD. See the appropriate VSE publications for information on coding 
EXTENT statements. 


Note: The input history tape must have a standard label, and the blocksize 
for the input history data set cannot exceed 4000. 


IECEREP1, the EREP program, retrieves all or selected records from the 
history data set (and from SYSREC, if you code MERGE) and writes them 
to an output device supported by the sequential access method (SAM). 


You can use the history data set or SYSREC, or both, as input to EREP, 
but you must use at least one of them. If you do use the history data set, 
you must also code the following: 


|| ASSGN SYS008,cuu 
Assigns the history data set to a logical unit, which is at address “cuu” (one- 
digit channel, two-digit unit address). 


The logical units are consistent for the various EREP data sets; history 
input is always assigned to SYSO08. 


/{ DLBL IJSYS01 

[|| EXTENT SYS001,xxxx,1,,xxxx,xx 
Defines the DASD temporary work data set required when you use history 
input for a report. See the appropriate VSE manual for information on the 
EXTENT statement. 


SYS001 should already be defined for the linkage editor, so these two state- 
ments may not be necessary. The standard SYS001 EXTENT should 
provide enough space for most IFCEREP!1 activity; but you must be sure 
there is enough space to hold all the records selected from the input data 
set(s). 


This data set is needed only if you are requesting a printed report. 


JCS for VSE 


|| ASSGN SYS001,cuu 
Assigns the work data set (DIRECTWK) to logical unit SYSO01 at address 
“cuu” (One-digit channel, two-digit unit address). SYSOO1 must be a single- 
extent data set. See “DASD Space for SYS001” on page 4-18 for more 
information about space for this data set. 


/{ TLBL HISTOT or DLBL HISTOD 

(// EXTENT SYS009,xxxx,1,,xxxx,xx, for DASD) 
Defines the tape (TLBL) or DASD (DLBL) output history data set; the 
ACCDEV data set. If you code or imply ACC =Y, you must code this 
label statement and the following ASSGN statement, so EREP will know 
where to put the records it accumulates. 


The output history tape must have a standard label. 


|| ASSGN SYS009,cuu 
Assigns the output (ACCDEV) data set to logical unit SYSO009. 


The following assignments should have been made when the partition was initial- 
ized; otherwise, EREP cannot run. If for some reason they were not, you must 
re-IPL in order to make the assignments. Issuing ASSGN statements for any of 
these logical units while running EREP results in a JCL error. 


|| ASSGN SYSREC,cuu 
Assigns the ERDS to system logical unit SYSREC. SYSREC is the system 
recording file on the system residence volume. 


SYSREC is the default input data set for EREP. Unless you indicate that 
there is history input (EREP parameter HIST or MERGE, and the 
HISTINT or HISTIND label statement), EREP takes the records for the 
report you request from SYSREC. 


|| ASSGN SYSIPT,cuu 
You code EREP parameters and control statements following the EXEC 
statement, as instream data. The system reads the data from the SYSIPT 
logical unit, so this ASSGN statement is always required. 


|| ASSGN SYSLST,cuu 
Assigns the data set for EREP (TOURIST) messages and EREP report 
output to system logical unit SYSLST. See “The TOURIST Output” on 
page 1-4 for information about TOURIST output. 


|| ASSGN SYSLOG, cuu 


Assigns the system log data set, required in case SYSLST is not available, to 
system logical unit SYSLOG. 
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VSE Storage Requirements 


Having set up the data sets required for EREP, you can now execute the 
program. 


// EXEC PGM =IFCEREP1,SIZE = xxxK or SIZE=AUTO 
Executes the EREP program. Note the use of the SIZE parameter; this may 
be necessary to make sure there is enough storage to hold the EREP 
program and its sort tables. EREP issues the GETVIS macro to obtain 
storage for its own modules and its sort tables. In addition to the program 
storage required for the initial EREP module, GETVIS requires 1K for each 
100 records over 400. See “VSE Storage Requirements.” 


VSE Storage Requirements 


Increasing Partition Size 
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EREP requires at least 100K of virtual storage. This provides for a sort table of 
4K bytes, the VSE TABSIZE default. The 4K-byte sort table permits the proc- 
essing of approximately 400 records for a report. 


If you have to increase the size of the sort table using the TABSIZE EREP 
parameter, you will probably have to increase the size of your virtual partition, 
too, by the amount you specify for the TABSIZE value minus 4K bytes. 


In addition, EREP can use two different sorting algorithms for its reports; the 
faster one requires additional storage equal to TABSIZE. If you can increase your 
partition size by the value of TABSIZE over the requirements outlined in 

Figure 4-] on page 4-17, you will significantly enhance EREP’s performance. 
EREP always tries to obtain the extra storage, and uses the faster sort routine if 
the storage is available. 


Several cases require you to increase the partition size when running EREP. 
Figure 4-] shows these cases and recommended amounts of partition increase for 
each. 


J 


VSE Storage Requirements 












INFLUENCING FACTOR AMOUNT OF PARTITION INCREASE 


You are using the TABSIZE The specified value of TABSIZE minus 
parameter 4K bytes 
You are including EREP The specified or default value of 
control statements TABSIZE 
You are using any of the fol- 4K bytes for any or all 
lowing selection parameters: 




















CPU 
CPUCUA 
CUA 

DEV 
DEVSER 
LIA/LIBADR 
MOD 
SYMCDE 
VOLID 


You are requesting Detail Edit 
reports (PRINT =PT, PS or 
AL) 


You are requesting a Detail 
Summary of 33XX records 
(not available in EREP 2.3 and 
later releases). 


A processor requires frames for | 150K bytes 

Detail Edit output 

You are requesting the System 6 times the specified or default value of 
Exception report series TABSIZE 


Figure 4-1. VSE Partition Size Increases for EREP 








4K bytes for each processor 










7K bytes 






Because you might not know how many input records to expect, these amounts of 
partition size increase are generous. Depending on installation restrictions, you 
may want to code SIZE=AUTO on the EXEC statement for the cases that 
require a lot of virtual storage. In rare instances, this may create a storage 
problem. There are several ways to correct this problem: 


e Increase the partition size to 1.7M or larger 

e Instead of SIZE=AUTO code SIZE=xxxK where xxx is 100 plus | for each 
100 records over 400. For example, for 900 records you would code 
SIZE = 105K. 


@e Do not code the SIZE parameter at all. 


Most of the steps in the VSE master example earlier in this chapter use 
SIZE = AUTO. 
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VSE Storage Requirements 


DASD Space for SYS001 
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In addition to the virtual storage needed to run EREP, VSE also requires DASD 
space for a temporary work data set whenever there are input records on a history 
data set. You request this auxiliary storage space on the DLBL/EXTENT state- 
ments for IJSYSO1, assigned to SYS001. 


If the SYS001 logical unit has already been assigned, check the space allocation 
on the EXTENT statement to make sure there is enough room for the input 
records. The amount of storage space required depends on the device type and 
the number of records being processed; Figure 12-8 on page 12-11 shows the 
approximate capacities of different types of DASD. 


J 


VSE Notes 


C VSE Notes 


The following short notes are meant to help you avoid potential problems as you 
create your EREP run for VSE. 


Access Methods 


EREP retrieves error records from SYSREC both sequentially, through the SAM 


access method, and randomly, through the EXCP (Execute Channel Program) 
system macro. 


It writes records to an output data set or buffer sequentially, through SAM. If 


you request specific devices for EREP’s output data, they must be supported by 
SAM. 


Special Considerations for EREP Parameters and Controls 


e You may only specify EREP parameters and control statements on input 
statements (as instream data; read from SYSIPT). 


e If you want the latest statistical and usage data included in the reports, the 
operator must issue the ROD (record on demand) command before running 
EREP against SYSREC, to force the system to dump the in-core and buffer 
counters to SYSREC before EREP begins its processing. 


e If VSE message OP77I appears after an EREP job is submitted, increase the 


t SIZE parameter value on the EXEC card. It might also be necessary to 
increase the partition size. See “VSE Storage Requirements” on page 4-16. 
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Running EREP under MVS 


Running EREP under MVS 


Coding the JCL 
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There are several ways to code the JCL statements for your EREP run. The fol- 
lowing examples will illustrate some of the more common of these. You should 
consult the JCL manual for your MVS system for further restrictions on format. 


1. Coding the parameters on the EXEC statement. Control statements are in 
the file specified on the SYSIN statement. 


//STEP 
//ACCIN 

/ /DIRECTWK 
/ /EREPPT 
//TOURIST 
//SYSIN 


EXEC 


DD 
DD 
DD 
DD 
DD 


PGM=IFCEREP1,PARM=('PRINT=PS,HIST,ACC=N' ) 
DSN=EREP.HISTORY , DISP=(OLD,PASS) 
UNIT=SYSDA,SPACE=(CYL,5,,CONTIG) 
SYSOUT=A , DCB=BLKSIZE=133 

SYSOUT=A ,DCB=BLKSIZE=133 
DSN=EREP.CNTRL,DISP=(OLD, PASS) 


The EXEC statement may be coded with or without the parentheses and with 
a single set of quotes only if all of the parameters fit on one line. 


//STEP 


EXEC PGM=IFCEREP1,PARM='PRINT=PS,HIST,ACC=N' 


If the parameters will not fit on one line then parentheses and individual 


quotes are required. 


//STEP 
If 


/ / STEP 


EXEC PGM=IFCEREP1,PARM=('PRINT=PS',HIST, 


"ACC=N','TYPE=OT' ) 


EXEC PGM=IFCEREP1,PARM=('PRINT=PS' ,HIST, 'ACC=N' ) 


Using the parentheses and the individual quotes is the preferred method. 


2. Coding PARM=’CARD’ and entering the parameters and the control state- 
ments on the SYSIN statement. 


//STEP 

/ /ACCIN 

/ /DIRECTWK 
/ /EREPPT 
//TOURIST 
//SXSIN 
PRINT=PS 
HIST 

ACC=N 
TYPE=OT 
ENDPARM 
SHARE 
LIMIT 
DASDID . 
CONTROLLER 


Z* 


EXEC 


DD 
DD 
DD 
DD 
DD 


PGM=IFCEREP1,PARM='CARD' 
DSN=EREP.HISTORY , DISP=(OLD,PASS) 
UNIT=SYSDA,SPACE=(CYL,5,,CONTIG) 
SYSOUT=A , DCB=BLKSIZE=133 
SYSOUT=A , DCB=BLKSIZE=133 

x 


All of the EREP parameters are described in detail in Chapter 7, “EREP 
Parameters”; the EREP control statements in Chapter 8, “EREP Control 


Statements.” 


a 
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The History Dataset 


Running EREP under MVS 


You should always create a history data set before running your EREP reports. 
This insures consistency across the reports. 


The operating system adds records to the ERDS continually. If you run your 
reports against the ERDS (HIST =N) then the set of records used by the first 
report is not the same as the set used by the next report since records could have 
been added while the report was running. By the time the last report is run the 
set of records may be quite different. 


By creating a history data set and then running all of the reports against that data 
set you insure that all of the reports are using the same set of records. 


The JCL on pages 4-22 through 4-30 shows an MVS job with several steps. The 
first step creates a history data set which is used in the remainder of the steps. 
This is only an example. You must decide which reports are relevent to your 
installation, what order they should be generated in and how often they should be 
run. 
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System Summary/Copy LOGREC (MVS) 





Create a History Dataset 


//EREPDAY JOB 


//STEP1 
// 


/ /SERLOG 


/ /ACCDEV 


as 
// 
tt 


/ /EREPPT 
//TOURIST 


//SYSIN 
// 


ps 


EXEC 


DD 


DD 


DD 
DD 


DD 


Create a history data set to be used in later report generation: 


e Generate a System Summary report from the records in SYS1.LOGREC 


e Copy the records from LOGREC to another disk data set 


e Zero LOGREC. 
{accounting information] 


PGM=IFCEREP1,PARM=(SYSUM, 
‘ACC=Y' , ZERO) 


DSN=SYS1.LOGREC , DISP=OLD 


UNIT=SYSDA,DSN=EHISTORY, 
DISP=(NEW,PASS,CATLG), 
SPACE=(CYL,(5,5)), 

DCB= (RECFM=VB , BLKSIZE=4000) 


SYSOUT=A , DCB=BLKSIZE=133 
SYSOUT=A , DCB=BLKSIZE=133 


DSN=EREP.CONTROLS, 
DISP=(OLD,PASS) 
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MSGLEVEL=1 


Requests a System Summary. The records are to be 
copied from LOGREC to the ACCDEV data set and 
LOGREC is to be zeroed out. When you code ACC=Y 
with SYSUM, EREP always clears LOGREC, even if 
you code ZERO=N. 


Using the records in LOGREC. If you omit this DD 
statement and do not code ACCIN/HIST or MERGE, 
EREP still uses LOGREC as input. 


This data set will be used as input for the rest of reports 
in EREPDAY. 


EREP requires a 132-position printer or both could be 
sent to a display device for online viewing. 


This data set contains the EREP control statements 
needed for all the reports. EREP uses only those that 
apply to the report requested in this step. 


This delimiter is optional; see the JCL manual for your 
MVS system. 


System Exception Reports (MVS) 


C System Exception Reports 


//STEP2 EXEC 


// 

// 

//ACCIN DD 
4 //DIRECTWK DD 

// 

/ /EREPPT DD 

//TOURIST DD 

//SYSIN DD 

// 

/* 


Generate the series of System Exception reports for processors, channels, and 
DASD and tape subsystems: 


e A System Error Summary in two parts: 

1. IPL/restarts, machine and channel checks 

2. DASD and tape I/O errors across processors. 

A Subsystem Exception report for each processor 

A Subsystem Exception report on channel failures, one for each processor 

A Subsystem Exception report on DASD failures 

A Subsystem Exception report on tape failures 

A series of detailed summaries for DASD presenting data by symptom code, 

storage control unit, string, and volume 

e A series of detailed summaries for 34XX tape devices presenting permanent 
and temporary errors by CUA/device number and volume. 


PGM=IFCEREP1,REGION=4K, The System Exception series requires a large sort table 
PARM=(SYSEXN, 'TABSIZE=512K', (TABSIZE), and thus more storage (REGION). The 
HIST, 'ACC=N'‘ ) input records are in the history data set, and are to stay 


there. The DASDID, LIMIT, and SHARE statements 
needed for the System Exception reports are in the data 
set named on the SYSIN DD statement. 


DSN=EHISTORY,DISP=(OLD, PASS) The data set created in STEP1. Multiple history data 
sets can be concatenated on this DD statement. 


UNIT=SYSDA, Workspace for EREP, required with history input. 
SPACE=(CYL,5,,CONTIG) 


SYSOUT=A , DCB=BLKSIZE=133 EREP requires a 132-position printer or both could be 
SYSOUT=A, DCB=BLKSIZE=133 sent to a display device for online viewing. 
DSN=EREP.CONTROLS, This data set contains the EREP control statements for 
DISP=(OLD,PASS) all the reports. EREP uses only those that apply to the 


report requested in this step. 
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Detail Reports (MVS) 


MCH and CCH Detail Reports 


//STEP3 EXEC 
Th 


//ACCIN DD 


//DIRECTWK DD 
// 


/ /EREPPT DD 
//TOURIST ODD 
//SYSIN DD 
// 
yes 


Print Detail Edits and Summaries of all machine and channel checks. 


PGM=IFCEREP1,PARM=('PRINT=PS", Requesting both Detail Edits and Summaries. Selecting 


'TYPE=MC',HIST, 'ACC=N' ) 


DSN=EHISTORY , DISP=(OLD, PASS) 


UNIT=SYSDA, 
SPACE=(CYL,5,,CONTIG) 


SYSOUT=A,DCB=BLKSIZE=133 
SYSOUT=A, DCB=BLKSIZE=133 


DSN=EREP.CONTROLS , 
DISP=(OLD,PASS) 
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the records by type; MCH (M) and CCH (C). Input 
records are in the history data set, and are to stay there. 


The history data set. 


Workspace for EREP, required with history input. 


EREP requires a 132-position printer or both could be 
sent to a display device for online viewing. 


Control statements for all of the reports. EREP uses 
only those that apply to the report requested in this step. 


This delimiter is optional; see the JCL manual} for your 
MVS system. 


CC Threshold Summary 


//STEP4 EXEC 


// 
fi 
//ACCIN DD 
//DIRECTWK DD 
res 
/ /EREPPT DD 
//TOURIST DD 
//SYSIN DD 
Ve 

wy a 


A summary of tape I/O errors: 


e all permanent errors 


Threshold Summary (MVS) 


@ temporary errors that exceed | read or 15 writes. 


Includes records from 3410, 3420, and 8809 devices. 


PGM=IFCEREP1, 


PARM=('THRESHOLD=(001,015)', 


HIST, 'ACC=N') 


DSN=EHISTORY , DISP=(OLD,PASS) 


UNIT=SYSDA, 
SPACE=(CYL,5,,CONTIG) 


SYSOUT=A,DCB=BLKSIZE=133 
SYSOUT=A, DCB=BLKSIZE=133 


DSN=EREP.CONTROLS, 
DISP=(OLD, PASS) 


Requesting a Threshold Summary. The input records 
are in the history data set, and are to stay there. The 
default value for ACC with THRESHOLD is N — an 
exception to the rule — but it is wise to code the param- 
eter anyway. 


History data set. 


Workspace for EREP, required with history input. 


EREP requires a 132-position printer or both could be 
sent to a display device for online viewing. 


Contains EREP control statements for all of the reports. 
EREP uses only those that apply to the report requested 
in this step. 


This delimiter is optional; see the JCL manual for your 
MVS system. 
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Detail Reports (MVS) 


Detail Reports for Communications Devices 


//STEP5 EXEC 
// 
// 
// 


//ACCIN DD 


//DIRECTWK DD 
17 


/ /EREPPT DD 
//TOURIST ODD 


//SYSIN DD 
// 


y ha 


Print Detail Summaries of all errors for 3704, 3705 and 3725 communications 


controllers. 


PGM=IFCEREP1,PARM=('PRINT=SU', Requesting only Detail Summaries only. Selecting the 


'TYPE=OT', 
'DEV=(3704,3705,3725)', 
HIST, 'ACC=N' ) 


DSN=EHISTORY , DISP=(OLD,PASS) 


UNIT=SYSDA, 
SPACE=(CYL,5,,CONTIG) 


SYSOUT=A , DCB=BLKSIZE=133 
SYSOUT=A,DCB=BLKSIZE=133 


DSN=EREP.CONTROLS, 
DISP=(OLD,PASS) 
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records by type; OBR (O) and MDR (T). Selecting the 
records by device; the communications controllers. The 
input records are in the history data set, and are to stay 
there. 


History data set. 


Workspace for EREP, required with history input. 


EREP requires a 132-position printer or both could be 
sent to a display device for online viewing. 


Contains the control statements for all the reports. 
EREP uses only those that apply to the report requested 
in this step. 


This delimiter is optional; see the JCL manual for your 
MVS system. 


Detail Summaries for I/O Errors 


//STEP6 EXEC 
// 
// 
// 


//BRCCIN DD 


//DIRECTWK DD 
// 


//EREPPT DD 
//TOURIST DD 


//SYSIN 
// 


DD 


Ps! 


Detail Reports (MVS) 


Print Detail Summaries of all I/O errors not already covered in the preceding 


reports. 


PGM=IFCEREP1,PARM=('PRINT=SU', 
‘TYPE=DOTH', 

"DEV=(N34XX ,N3704,N3705,N3725)', 
HIST, 'ACC=N'‘) 


DSN=EHISTORY , DISP=(OLD, PASS) 


UNIT=SYSDA, 
SPACE=(CYL,5, ,CONTIG) 


SYSOUT=A , DCB=BLKSIZE=133 
SYSOUT=A , DCB=BLKSIZE=133 


DSN=EREP.CONTROLS, 
DISP=(OLD,PASS) 


Requesting only Detail Summaries. Selecting the records 
by type: DDR (D), OBR (O), MDR (T) and MIH (H). 
Selecting by device type; excluding those already 
covered. Note the absence of N33XX; EREP does not 
produce detail summaries for 33XX DASD anyway, so 
they need not be excluded. The input records are in the 
history data set, and are to stay there. 


History data set. 


Workspace for EREP, required with history input. 


EREP requires a 132-position printer or both could be 
sent to a display device for online viewing. 


Contains the control statements for all the reports. 
EREP uses only those that apply to the report requested 
in this step. 


This delimiter is optional; see the JCL manual for your 
MVS system. 


MVS Examples 4-27 


Detail Reports (MVS) 


Detail Reports for Software Records 


//STEP7 EXEC 
// 


//ACCIN DD 


//DIRECTWK DD 
// 


/ /EREPPT DD 
//TOURIST DD 


//SYSIN DD 


Fas 


Print Detail Edits and Summaries of all software and operational records. 


PGM=IFCEREP1,PARM=('PRINT=PS', Requesting both Detail Edits and Summaries. Selecting 


"TYPE=SIE' ,HIST, ‘ACC=N' ) 


DSN=EHISTORY , DISP=(OLD,PASS) 


UNIT=SYSDA, 
SPACE=(CYL,5, ,CONTIG) 


SYSOUT=A,DCB=BLKSIZE=133 
SYSOUT=A , DCB=BLKSIZE=133 


DUMMY 
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the records by type; SFT (S), IPL (I) and EOD (E). 
Input records are in the history data set, and are to stay 
there. 


History data set. 


Workspace for EREP, required for history input. 


EREP requires a 132-position printer or both could be 
sent to a display device for online viewing. 


aA 


EREP control statements do not apply to software 
records, so the SYSIN data set is not needed. 


This delimiter is optional; see the JCL manual for your 
MVS system. 


Event History Report 


//STEP8 EXEC 
Tf 


//BCCIN DD 


//DIRECTWK DD 
// 


/ /EREPPT DD 
//TOURIST DD 
//SXSIN DD 
7 es 


Event History (MVS) 


One-line abstracts of all records, in chronological order. 


PGM=IFCEREP1,PARM=(EVENT, 
HIST, 'ACC=N') 


DSN=EHISTORY , DISP=(OLD, PASS) 


UNIT=SYSDA, 
SPACE=(CYL,5,,CONTIG) 


SYSOUT=A , DCB=BLKSIZE=133 
SYSOUT=A , DCB=BLKSIZE=133 


DUMMY 


Requesting an Event History Report. Note the absence 
of selection parameters; the report is to include every 
record. The input records are in the history data set, 
and are to stay there. 


History data set. 

Workspace for EREP, required with history input. 
EREP requires a 132-position printer or both could be 
sent to a display device for online viewing. 


The Event History cannot use SHARE or CON- 
TROLLER control statements, so the SYSIN data set is 
not needed. 


This delimiter is optional; see the JCL manual for your 
MVS system. 
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Updating History Tape (MVS) 


Updating History Tape 


//STEP 
// 


/ /ACCIN 
/ /ACCDEV 


// 
// 


/ /DIRECTWK 
// 


//EREPPT 


//TOURIST 


//SYSIN 


j* 


EXEC 


DD 


DD 


DD 


DD 


DD 


DD 


1. Copy the records on the input data set (EHISTORY) to the history tape 
(EREP.HIST.TAPE), either creating or updating it. 
2. Delete the EHISTORY data set; the updated history tape is the input for the 


final step. 


PGM=IFCEREP1,PARM=('PRINT=NO', 
HIST, 'ACC=Y') 


DSN=EHISTORY , DISP=(OLD, PASS) 


DSN=EREP.HIST.TAPE, 
DISP=(MOD,PASS) , VOL=(,RETAIN), 
DCB= (RECFM=VB, BLKSIZE=12000) 


UNIT=SYSDA, 
SPACE=(CYL,5,,CONTIG) 


DUMMY 


SYSOUT=A , DCB=BLKSIZE=133 


DUMMY 
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Requesting no report output, but the records are to be 
copied (“accumulated”; ACC = Y) from the working 
data set to the output data set named on the ACCDEV 
DD statement. 


Input records are in the history data set. 
The output data set to receive the records. If it did not 
already exist, DISP=(NEW,PASS) would create it. 


Workspace for EREP, required for history input. 


No printed report this time. 
Do want to see the messages, however. EREP requires a 


132-position printer or the messages could be sent to a 
display device for online viewing. 


No report, no control statements. 5 


This delimiter is optional; see the JCL manual for your 
MVS system. 


Trends Report 


//STEP10 EXEC 
77. 


//ACCIN DD 
res 


//DIRECTWK DD 
// 


/ /EREPPT DD 
//TOURIST DD 


//SYSIN DD 
Ty 


Paw 


Trends Report (MVS) 


Print a Trends report covering the last 30 days of records from the newly updated 


history tape. 


PGM=IFCEREP1,PARM=(TRENDS, 
HIST, 'ACC=N' ) 


DSN=EREP.HISTORY.TAPE, 
DISP=(OLD, KEEP) 


UNIT=SYSDA, 
SPACE=(CYL,5,,CONTIG) 


SYSOUT=A , DCB=BLKSIZE=133 
SYSOUT=A , DCB=BLKSIZE=133 


DSN=EREP.CONTROLS, 
DISP=(OLD,KEEP) 


Requesting the Trends report. Without the DATE 
parameter, Trends uses the last 30 days of records. The 
history data set referred to here is the one updated or 
created in Step 9. 


The “new” input data set, containing the records EREP 
is to use for the Trends report. 


Workspace for EREP, required for history input. 


EREP requires a 132-position printer or both could be 
sent to a display device for online viewing. 


The SHARE and CONTROLLER control statements 
needed for the Trends report are in this data set. 


This delimiter is optional; see the JCL manual for your 
MVS system. 
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JCL for MVS 


MVS System Controls 
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In addition to the parameters and controls EREP needs to process records and 
produce reports, the MVS systems require system controls (JCL) that create the 
interface between EREP and the operating system’s data management functions. 
You provide these as part of the EREP run, as follows: 


//JOB statement 
Required; initiates the job. May include the REGION parameter, to 
increase the virtual storage available to EREP via GETMAIN. 


//EXEC statement 
Required; executes the EREP program. This is one place to request more 
storage to accommodate EREP; use the REGION parameter. You may 
include the EREP keyword parameters (PARM =’xxx = x’,’yyy=y’) here or 
indicate that they are being entered as SYSIN data (PARM =’CARD’). 
Because of fairly intricate syntax requirements when coding them here, 
many users prefer the PARM =’CARD’/instream SYSIN data method. 
However, see the discussion of the SYSIN DD statement (see page 4-33). 


[{/ACCIN DD statement 
Required with history input; defines the history input data set. 


IFCEREP1, the EREP program, retrieves records from the history data set 
(and/or from SYS1.LOGREC), and writes them to any QSAM-supported 
output device. See “MVS Notes” on page 4-36 for more information about 
LOGREC processing. 


The history input can be in more than one data set; you can concatenate the 
DD statements, making sure the record formats (RECFM) are either 
blocked or unblocked but not both. The data set with the largest blocksize 
must be first in the concatenation, so the system will allocate a device suit- 
able for all the data sets. 


See “MVS Notes” on page 4-36 for more information about the DCB 
requirements for this data set. 


//DIRECTWK DD statement 
Required with history input. Defines and allocates DASD space for the 
temporary work data set needed to process history (ACCIN) input records. 


[/{SERLOG DD statement 
Required with LOGREC input in older MVS systems. Defines 
SYS1.LOGREC, the system error recording data set, as the input data set. 
You may use LOGREC or a history data set as input, but you must use at 
least one of them for every execution of EREP. 


LOGREC is the default input data set for EREP under MVS. Unless you 
indicate that there is history input (EREP parameter HIST or MERGE, and 
the ACCIN DD statement), EREP takes the records for the report you 
request from LOGREC. When you code the MERGE parameter, you must 
also code both the ACCIN and SERLOG DD statements. 


~é 


JCL for MVS 


/{ACCDEV DD statement 
Defines and allocates space for the output history data set. You only need 
this DD statement if you want EREP to accumulate the records to an 
output data set after completing the report (ACC=Y). The data set can 
reside on DASD or magnetic tape. 


Note: If you code this DD statement as ACCDEV DD DUMMY and then 
default to or specify ACC =Y, you are telling EREP to write the records to 
a nonexistent data set. 


When you first define this data set, you will have to include some DCB 
information on the DD statement. See the JCL manual for your MVS 
system for information on how to do this. 


//EREPPT DD statement 
Defines and allocates space for the output data set that holds the EREP 
report. You must code this DD statement whenever you request a printed 
report. The output device need not be a printer, however; specifying the 
SYSOUT class for online display allows you to view the report at a TSO 
terminal. 


[[TOURIST DD statement 
Defines and allocates space for the output data set that holds EREP mes- 
sages and processing information. You must code the TOURIST DD state- 
ment whenever you run EREP. You can send the TOURIST output to the 
SYSOUT class, or let it default to the message class for the job, or spool it 
to a JES device. 


[/SYSIN DD statement 
Defines the data set you use to enter EREP controls as instream data. 


This data set is always required for EREP control statements; they must be 
coded as SYSIN data. You can include EREP parameters as well, if you 
code PARM =’CARD*’ on the EXEC statement and separate the parameters 
from the control statements with ENDPARM. See “Coding Control 
Statements” on page 8-3 and “Coding EREP Parameters” on page 7-1 for 
how to do this. 


Because control statements are fairly complicated to code, it is a good idea 
to put them all into a separate data set and name the data set on the DSN 
parameter. EREP uses only those control statements that apply to a 
requested report, so you need not put SHARE/CONTROLLER statements 
in one data set and DASDID/LIMIT statements in another (although it is 
possible to do so, concatenating the DD statements for the two data sets.) 
The sample EREP setups earlier in this chapter use this method of entering 
control statements. 


Even when you have no control statements or parameters to enter as SYSIN 


data, it is wise to supply a SYSIN DD statement; the operating system 
expects one. Code itas //SYSIN DD DUMMY. 
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MVS Storage Requirements 


MVS Storage Requirements 


Increasing Region Size 
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EREP requires at least 100K bytes of virtual storage for its internal sort table. 
100K provides for a 24K-byte sort table, the MVS TABSIZE default. EREP can 
process approximately 2400 records in a 24K sort table. Depending on the kind 
of report you are running, and on the number of records involved, you might 
have to increase the sort table size for a single EREP run or for all your EREP 
reports. The System Exception series, for example, requires a large sort table; the 
recommended value for TABSIZE when requesting SYSEXN in a large installa- 
tion is 512K. 


If you increase the size of the sort table using the TABSIZE processing parameter, 
you might have to increase the virtual storage (region) size as well, using the 
REGION parameter on either the JOB or EXEC statement. See the JCL manual 
for your MVS system for how to do this. 


In addition, EREP can use two different sorting algorithms for its reports; the 
faster one requires additional storage equal to TABSIZE. If you can increase your 
region size by the value of TABSIZE over the requirements outlined in Figure 4-2 
on page 4-35, you will significantly enhance EREP’s performance. EREP always 
tries to obtain the additional storage, and uses the faster sort routine if the 
storage is available. 


Several conditions can require you to increase the region size when running 
EREP. Figure 4-2 shows these conditions and recommended amounts of region 
increase for each. 


J 


J 


MVS Storage Requirements 










INFLUENCING FACTOR 


You are using the TABSIZE The specified value of TABSIZE minus 
parameter 4K bytes 

You are using EREP control The specified or default value of 
statements TABSIZE 

You are requesting the System 6 times the specified or default value of 
Exception report series TABSIZE 


You are using any of the fol- 4K bytes for any or all 
lowing selection parameters: 


AMOUNT OF REGION INCREASE 





















CPU 
CPUCUA 
CUA 

DEV 
DEVSER 
LIA/LIBADR 
MOD 
SYMCDE 
VOLID 


You are requesting Detail Edit | 4K bytes for each processor 
reports (PRINT =PT, PS or 
AL) 


You are requesting a Detail 7K bytes 
Summary of 33XX records 
(not available in EREP 2.3 and 
later releases.) 


A processor requires frames for | 150K bytes 
Detail Edit output 


Figure 4-2. MVS Region Size Increases for EREP 













DASD Storage for DIRECTWK 


In addition to the virtual storage needed to run EREP, MVS also requires DASD 
space for EREP’s temporary work data set whenever your input includes records 
on a history data set. You request this storage using the SPACE parameter on 
the DIRECTWK DD statement, making sure the storage is in a contiguous block 
(SPACE = (CYL,5,,CONTIG)). 


The amount of storage depends on the device type and the number of records to 
be processed. Figure 12-8 on page 12-11 shows the capacities of different types 
of DASD. 
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MVS Notes 


MVS Notes 


Access Methods 


DCB Requirements 
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The following notes are meant to help you avoid potential problems as you create 
the interface between EREP and your system control program. 


EREP retrieves error records from SYS1.LOGREC both sequentially, through the 
QSAM access method, and randomly, through the MVS system macro EXCP 
(Execute Channel Program). 


It writes records to an output data set or buffer sequentially, through QSAM. If 
you request specific devices for EREP’s output data, they must be supported by 
QSAM. 


The DD statements you code in the JCL for an EREP run are there to define and 
allocate storage for the data sets EREP uses in its processing. 


If you wish to add DCB attributes to the other information on the DD statement, 
make sure they are really needed to override the DCB information already built 
by the system. This is described in SPL: Data Management and the JCL manual 
for your system. Following is some specific information you may need when first 
setting up your EREP run. 


Both the input (ACCIN) and output (ACCDEV) data sets have special DCB 
requirements. 


ACCIN You must supply the RECFM and BLKSIZE values if: 


e the data set resides on an unlabeled tape volume or 
e the data set is not included in a DSCB (data set control 
block) 


ACCDEV You must supply the RECFM and BLKSIZE values for this 
data set if it is not included in a DSCB. 


RECFM = VB and BLKSIZE = 12000 for tape, and full track blocking for DASD, 
give the best performance results. 


The blocksize for a tape data set must be at least 2004. 


A blocksize of 6144 for a DASD data set allows for the various blocking factors 
among DASD, and improves performance. 


In addition to these, you can supply a blocksize for the SYSIN data set; for the 
usual input media — cards or card images on a terminal screen — the BLKSIZE 
value is 80. 


MVS Notes 


( Running EREP in a Multisystem Environment 


If you do not combine the error data from all of the systems that share I/O 
devices, you will not have a complete picture of the performance of the devices. 


In a multisystem environment there are several things you can do to process the 


data efficiently and get accurate reports. See “Information about the MVS SCP” 
in Part 4 for suggested procedures. 
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Running EREP under VM 


Running EREP under VM 


The History Dataset 
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The following series of examples do the same things as the procedures for VSE 
and MVS earlier in this chapter. These are only examples. You must decide 
which reports are relevent to your installation, what order they should be gener- 
ated in and how often they should be run. 


The examples are presented as pieces of a single EXEC that includes multiple exe- 
cutions of the CPEREP command using different sets of operands each time. The 
operands have been put in files created using XEDIT; the correct file is named on 
each CPEREP command. The actual contents of the files are included in the 
examples. 


There are other methods for entering the operands for the CPEREP command; 
see “Entering CPEREP Operands” on page 9-8 and “Using EREP Controls as 
CPEREP Operands” on page 9-3. 


The first section of the EXEC defines the input and output files needed for 
EREP. EREP automatically sends its output to the devices named on the 
EREPPT and TOURIST file definition statements. The execution of the 
CPEREP command includes the writing and routing of the output. 


All of the EREP parameters are described in detail in Chapter 7, “EREP 
Parameters.” The EREP control statements in Chapter 8, “EREP Control 
Statements.” 


You should always create a history data set before running your EREP reports. 
This insures consistency across the reports. 


The operating system adds records to the ERDS continually. If you run your 
reports against the ERDS (HIST =N) then the set of records used by the first 
report is not the same as the set used by the next report since records could have 
been added while the report was running. By the time the last report is run the 
set of records may be quite different. 


By creating a history data set and then running all of the reports against that data 
set you insure that all of the reports are using the same set of records. 


System Summary/Copy ERDS (VM) 


Cc Create a History Dataset 


Create a history data set to be used in later report generation: 


@ Generate a System Summary report from the records in the error-recording 


area 


@ Copy the records from the error-recording area to a working data set 


@ Clear the error-recording area 


FILEDEF DIRECTWK DISK DIRECTWK EREPWORK * 


DET 182 


FILEDEF ACCDEV DISK EHISTORY DAILY * 
(RECFM VB BLKSIZE 12000 


FILEDEF EREPPT PRINTER 
(NOCHANGE BLKSIZE 133 


& FILEDEF TOURIST TERMINAL 
(BLKSIZE 133 


EXEC CPEREP STEP1 INPUT A 


SYSUM 


ACC=Y 


ZERO=Y 


ENDPARM 


SHARE= ... 


Workspace for EREP; required when there is history 
input. This file is for later steps. In this first step, the 
input is in the file defined by CPEREP as SERLOG; see 
“Defining Files for CPEREP” on page 4-49. 


CPEREP expects the ACCDEV file to be on TAPE 182, 
already defined by the system. If you want to keep the 
records on disk, you must also detach (or redefine) 
TAPE 182. See “VM Notes” on page 4-51. 


Output history file (ACC = Y). 
Sending the System Summary report to the printer. 
Note that EREP requires a 132-position printer. 


EREP informational messages will appear on the screen, 
instead of being printed with the report. 


The contents of file STEP1 INPUT A are the CPEREP 
operands listed here. 


Requesting the System Summary. 


Directing EREP to copy the records from the 
ERDS to EHISTORY DAILY. 


Directing EREP to clear the ERDS. 


End of EREP parameters; EREP control 
statements follow. 


For any devices shared by processors. 


VM Examples 4-39 


System Exception Reports (VM) 


System Exception Reports 


Generate the series of System Exception reports for processors, channels, and 
DASD and tape subsystems: 


A System Error Summary in two parts: 

1. JPL/restarts, machine and channel checks 

2. DASD and tape I/O errors across processors. 

A Subsystem Exception report for each processor 

A Subsystem Exception report on channel failures, one for each processor 
A Subsystem Exception report on DASD failures 

A Subsystem Exception report on tape failures 

A series of detailed summaries for DASD presenting data by symptom code, 
storage control unit, string, and volume 

A series of detailed summaries for 34XX tape devices presenting permanent 
and temporary errors by CUA/device number and volume. 


You must now define as input to this report the file containing the records copied 
from the ERDS in the previous step. This is the working copy of the ERDS; it is 
used as input for all of the remaining reports. 


DEF STOR 2M 


Need more virtual storage for a large sort table. 


FILEDEF ACCIN DISK EHISTORY DAILY * Redefining EHISTORY DAILY as ACCIN; the records 


in this file are input for the rest of the reports. 


EXEC CPEREP STEP2 INPUT A The contents of file STEP2 INPUT A are the CPEREP 


operands listed here. 


SYSEXN Requesting the System Exception series. 

HIST Input records are in the history data set. 

ACC=N Leave them there. 

TA BSIZE= 512K System Exception processing requires a large 
sort table. 

ENDPARM End of parameters; control statements 
follow. 

DASDID ... For DASD not providing their own physical 
IDs. 

LIMIT ... To limit the number of records appearing on 
the reports. 

SHARE . For devices shared between processors. 
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Detail Reports (VM) 


C MCH and CCH Detail Reports 


Print Detail Edits and Summaries of all machine and channel checks. 
DEF STOR 1M Returning virtual storage to its orginal size. 


EXEC CPEREP STEP3 INPUT A The contents of file STEP3 INPUT A are the CPEREP 
operands listed here. 


PRINT=PS Requesting Detail Edits and Summaries of 
the input records. 


TYPE=MC Selecting the records by type: 
M MCH 
C CCH 
HIST Input records are in the history data set. 
ACC=N Leave them there. 
ENDPARM End of parameters; control statements 
follow. 
SHARE ... For devices shared between processors. 
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Threshold Summary (VM) 


Threshold Summary 


A summary of tape I/O errors: 


e all permanent errors 
@ temporary errors that exceed | read or 15 writes. 


Includes records from 3410, 3420, and 8809 devices. 


EXEC CPEREP STEP4 INPUT A The contents of file STEP4 INPUT A are the CPEREP 
operands listed here. 


THRESHOLD= (001,015) Requesting a Threshold Summary. 

HIST Input records are in the history data set. 

ACC=N Leave them there. 

ENDPARM End of parameters; contro] statements 
follow. 

SHARE ... For devices shared between processors. 
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Detail Reports for Communications Devices 


Detail Reports (VM) 


Print Detail Summaries of all errors for 3704, 3705 and 3725 communications 


controllers. 


EXEC CPEREP STEP5 INPUT A 


PRINT=SU 


TYPE=OT 


DEV = (3704 ,3705,3725) 


HIST 
ACC=N 


ENDPARM 


SHARE .. 


The contents of file STEPS INPUT A are the CPEREP 
operands listed here. 


Requesting only Detail Summaries. 


Selecting the records by type: 


O OBR 
T MDR 


Selecting by device type; the communications 
controllers. 


Input records are in the history data set. 
Leave them there. 


End of parameters; control statements 
follow. 


For devices shared between processors. 
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Detail Reports (VM) 


Detail Summaries for I/O Errors 


Print Detail Summaries of all I/O errors not already covered in the preceding 


reports. 


EXEC CPEREP STEP6 INPUT A 


PRINT=SU 


TYPE= DOTH 


DEV = (N34XX,N3704,N3705,N3725) 


AIST 
ACC=N 


ENDPARM 


SHARE ... 
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The contents of file STEP6 INPUT A are the CPEREP 
operands listed here. 


Requesting only Detail Summaries. 


Selecting the records by type: 


D DDR 
O OBR 
T MDR 
H MIH 


Selecting by device type; excluding those 
already covered. Note the absence of 
N33XX; EREP does not produce detail sum- 
maries for 33XX DASD anyway, so they 
need not be excluded. 


Input records are in the history data set. 
Leave them there. 


End of parameters; control statements 
follow. 


For devices shared between processors. 


J 


C 


Detail Reports (VM) 


Detail Reports for Software Records 


Print Detail Edits and Summaries of all software and operational records. 


EXEC CPEREP STEP? INPUT A The contents of file STEP7 INPUT A are the CPEREP 
operands listed here. 


PRINT=PS Requesting both Detail Edits and Summa- 
ries. 

TYPE=SIE Selecting the records by type: 
S SIE 
I IPL 


E EOD (Termination) 
AIST Input records are in the history data set. 


ACC=N Leave them there. 
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Event History (VM) 


Event History Report 


One-line abstracts of all records, in chronological order. 


EXEC CPEREP STEP8 INPUT A The contents of file STEP8 INPUT A are the CPEREP 
operands listed here. 


EVENT Requesting an Event History Report. Note 
the absence of selection parameters; the 
report is to include every record. 


HIST Input records are in the history data set. 


ACC=N Leave them there. 
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C 


Update the History Tape (VM) 
Update the History Tape 


1. Copy the records from the input history data set to the permanent history 
tape. 
2. Delete the input history data set. 


FILEDEF ACCDEV TAPE HISTTAPE WKLY This is the permanent history tape, on which the 
(RECFM VB BLKSIZE 133 working data set is to be copied. 
EXEC CPEREP STEP9 INPUT A The contents of file STEP9 INPUT A are the CPEREP 
operands listed here. 
PRINT=NO Requesting no report output. 
HIST Input records are in the history data set. 
ACC=Y Move the records to another data set. 
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Trends Report (VM) 


Trends Report 
Print a Trends report covering the last 30 days of records from the newly updated 
history tape. 
FILEDEF ACCIN TAPE Redefining the former ACCDEV data set as ACCIN; 
HISTTAPE WKLY * the updated history tape is now being used as input. 
EXEC CPEREP STEP10 INPUT A The contents of file STEP10 INPUT A are the CPEREP 
operands listed here. 
TRENDS Requesting the Trends report. Without the 
DATE parameter, Trends uses the last 30 
days of records. 
AIST Input records are still in a history data set 
rather than the ERDS. 
ACC=N Leave them there. 
ENDPARM End of parameters; control statements 
follow. 
SHARE ... For devices shared between processors. 
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VM System Controls 


CPEREP Interface 


The interface between EREP and the VM facility is the CMS command CPEREP. 
From the CMS environment, you enter the CPEREP command to begin an exe- 
cution of the EREP program. You enter EREP parameters and control state- 
ments as operands for the CPEREP command, using one of several methods of 
entry. 


The operands are in the same format as the EREP parameters and control state- 
ments in VSE or MVS jobs; in essence, you are submitting them as SYSIN data 
to the virtual machine’s system control program. 


See Chapter 9, “CPEREP Operands - Syntax and Coding” for detailed informa- 
tion on the operands and how you use them. 


Defining Files for CPEREP 


The CPEREP command processor invokes IFCEREPI1, specifying the EREP con- 
trols you have entered as command operands. The command processor also 
defines the files necessary for running EREP. You can change the FILEDEFs 
before executing the CPEREP command and override the definitions the 
command processor would use. 


Following are the “default” file definitions set up by CPEREP. CPEREP uses the 
MVS version of EREP, so the FILEDEF commands it issues correspond to the 
DD statements used by MVS: 


FILEDEF EREPPT PRINTER (NOCHANGE BLKSIZE 133 

FILEDEF SYSIN DISK SYSIN EREPWORK X3 

FILEDEF SERLOG DISK SERLOG EREPWORK (BLOCK 4096 
FILEDEF TOURIST TERMINAL (BLKSIZE 133 

FILEDEF DIRECTWK DISK DIRECTWK EREPWORK X4 

FILEDEF ACCDEV TAP1 (NOCHANGE RECFM VB BLKSIZE 12000 
FILEDEF ACCIN TAP2 (NOCHANGE RECFM VB BLKSIZE 12000 


EREPPT 
is EREP’s printer file, to which it sends the report output. You can over- 
ride this FILEDEF with one of your own before issuing the CPEREP 
command; to change the destination from PRINTER to TERMINAL, for 
example. 


CPEREP leaves the FILEDEF for EREPPT intact at the end of the run, in 
case you supplied it. 


SYSIN 
is the file where CPEREP puts your parameters and control statements for 
EREP. It 1s put on the read/write disk having the most available space, and 
is automatically erased at the end of the run. If there is no data for SYSIN, 
CPEREP issues FILEDEF SYSIN DUMMY. When you are entering oper- 
ands by the file entry method, make sure the name of the file on this 
FILEDEF statement is the same as the file you name on the CPEREP 
command line. 
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Defining Files for CPEREP 
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SERLOG 


is a simulation of the SYS1.LOGREC data set, required by the OPEN and 
CLOSE macros that EREP issues during its processing. When SERLOG is 
the input file, the records are actually read from the VM error-recording 
area; no SERLOG file exists on any disk. See “VM Notes” on page 4-51 
for some interesting insights into VM’s error recording. 


TOURIST 


is the message data, which is directed to your terminal screen. The messages 
and diagnostic information EREP writes to this file include printer control 
characters, which might appear on the display screen as unknown charac- 
ters. 


DIRECTWK 


is a work file EREP uses when there is history input. This file can be quite 
large, because it contains all the input error records selected from the 
history tape. DIRECTWK is put on the read/write disk having the most 
available space, and is erased at the end of the run. 


ACCDEV 


is the output history file, used if you specify or imply ACC=Y. CPEREP 
puts this file on tape drive 181, but you can override that definition with 
your own FILEDEF prior to issuing the CPEREP command. However, 
defining ACCDEYV to any device other than tape 181 can cause problems 
when CPEREP positions the tape so EREP can write records to the file; see 
“VM Notes” for more details. 


CPEREP leaves the FILEDEF for ACCDEV intact at the end of the run, in 
case you supplied it. 


ACCIN 


is the input history file, used if you specify or imply HIST=Y or 
MERGE=Y. CPEREP puts this file on tape drive 182, but you can over- 
ride that definition with your own FILEDEF prior to issuing the CPEREP 
command. However, defining ACCIN to any device other than tape 182 
can cause problems when CPEREP positions the tape so EREP can read 
records from the file; see “VM Notes” for details. 


CPEREP leaves the FILEDEF for ACCIN intact at the end of the run, in 
case you supplied it. 


J 
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VM Notes 


VM Notes 


Running EREP under VM is quite different from running it under either of the 
other S/370 operating systems. Your access to the system is through the CPEREP 
command; CMS actually runs EREP for you, simulating the OS/VS2 environ- 
ment. 


VM simulates the OS/VS2 operating system when you invoke EREP, even when 
your input records are from an OS/VS1 or a VSE system. 


Using Different Input and Output FILEDEFs for CPEREP 


Before you issue the CPEREP command, you can define your own ACCDEV and 
ACCIN files using the FILEDEF command, and designate the devices you want 
to hold the files. Normally, you would only need to do this if you were using a 
history tape from another system as input to EREP, or if you wanted to accumu- 
late the data to another tape drive or to a disk file. 


Defining your own file for ACCDEV or ACCIN could lead to problems in 
reading or writing the records from or to the file, however. If you specify or 
imply ACC=Y for an EREP run, CPEREP rewinds tape 181, spaces forward 
over the existing file, and backspaces over the tape mark before writing any 
records to the file. It does this so it writes new records at the end of the accumu- 
lation file. Similarly, if you specify HIST =Y or MERGE=Y, CPEREP rewinds 
tape 182 so it always starts reading records at the beginning of the file. 


For some VM systems, there is a catch to this. The catch 1s that, as long as tape 
drives 181 and 182 are attached to the virtual machine, CPEREP only, and 
always, positions those tapes. 


In older versions of VM, CPEREP assumes, when it sees ACC=Y, HIST=Y, or 
MERGE = Y, that the files are on tape drives 181 and 182. If tape 181 and/or 
182 is attached and ready, CPEREP positions it for writing or reading; if the tape 
is attached but not ready, CPEREP notifies the operator and waits for him to 
make it ready. It does not use the virtual device you defined in your FILEDEFS. 


To avoid this problem, you must do two things in each case: 

1. For ACCDEV, detach tape 181 before running CPEREP, and issue CMS 
TAPE commands with the appropriate “tapcmd” controls to position the tape 
you have defined before invoking CPEREP.! 


If you define the file to a disk, specify the DISP MOD option on the 
FILEDEF if you want to add records at the end of an existing file. 


2. For ACCIN, detach tape 182 and issue a CMS TAPE command! to rewind 
the ACCIN tape you have defined, before running CPEREP. 


If you define the file to disk, you need not do anything. 


I See the CMS Command and Macro Reference for your VM facility for information 
on the TAPE command and its options. 
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VM Notes 


FILEDEFs for Standard-Label Tapes ) 


If you are using standard-label tapes, you must issue your own FILEDEF for 
ACCDEV or ACCIN before running CPEREP, so the header labels are read cor- 
rectly. This is the correct FILEDEF for ACCDEV. 


FILEDEF ACCDEV address SL (RECFM VB BLKSIZE 12000 


This is the correct FILEDEF for ACCIN. 


FILEDEF ACCIN address SL (RECFM VB BLKSIZE 12000 


IMPORTANT. The address fer ACCDEV and the address for ACCIN must be dif- 
ferent. 
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General Input Facility 


Running the EREP General Input Facility 


Description 


Requirements 


Invocation 


Input 


Output 


The EREP General Input Facility passes records to EREP for Detail Edit proc- 
essing. Any program operating in an MVS environment can use this facility to 
pass records, one at a time, to EREP for processing. 


The facility is invoked for two functions: 


1. Process a record and format the Detail Edit report. 
2. Perform end-of-file processing and provide a total count of records processed. 


EREP does not directly read records or print reports through the General Input 
Facility interface. The caller is responsible for all I/O services. The caller sup- 
plies EREP with: 


e@ The address of a record already in storage 
e@ The address of an output routine that will print the report output and/or the 
end-of-file information 


EREP is invoked through the General Input Facility by LOADing and calling 
module IFCRCGIF. 


Input to the General Input Facility consists of the following parameter list, the 
address of which is passed in Register 1. 


FORMAT FIELD DESCRIPTION 

PTR(31) Address of ERDS record 

FIXED(31) Length of ERDS record 

PTR(31) EPA of caller’s print routine 

PTRG1) Address of data area to be passed to output routine (optional) 


Note: When the facility is invoked for end-of-file processing, the first two fields are 
set to zero. 


The output of the General Input Facility consists of the Detail Edit report, to be 
printed one line at a time, and a parameter list. Both of these are passed to the 
caller’s output routine, where the line is printed. Upon return from the output 
routine, EREP will return control to the caller. 
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General Input Facility 


Output Parameter List 


Output Line 


Restrictions 


Return Codes 
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FORMAT FIELD DESCRIPTION 

PTR(31) Address of output line 

PTR(31) Address of data area from input parameter list (optional) 
FORMAT FIELD DESCRIPTION 

CHAR(1) Output dataset indicator 


R_ report data set 
M_ message data set 
B both data sets 
CHAR(1) Carriage Control character 
X’FIl’ page eject 
X’1B’ immediate triple space 
X’‘19’ triple space after write 
X’13’ immediate double space 
X’11’ double space after write 
X’xx’ All others cause single space 
CHAR(132) Output line 


The record passed to EREP through the General Input Facility must reside below 
the 16-megabyte line. 


The following return codes may be passed back to the caller: 


CODE DESCRIPTION 
X’00’ Successful processing 
X’04’ Warning, processing unsuccessful. The requestor should perform 


default processing for this record. 


X’20’ Severe system-related errors. EREP cannot continue. The requestor 
should perform default processing for this and all subsequent 
records. 


Chapter 5. Correcting Coding Problems 


Syntax Errors 


There are four major causes of problems in running an EREP job: 
1. Incorrect syntax or use of an EREP parameter or control statement 
2. Inadequate storage for the data sets and work spaces EREP requires 


3. Some kind of I/O error — opening or closing data sets, reading data, writing 
data 


4. Flawed input data, usually caused by improper management of the error data, 
that results in incorrect report output. 


For the first three of these, you get messages from EREP or the operating system, 
or both, to help you identify and correct the problem. In the case of incorrect 
input, however, EREP usually issues no messages, so you have to identify the 
problem yourself. 


The following paragraphs summarize the recommended actions for each of the 
problem causes listed here. 


When your problem is a syntax error or an improper combination of parameters, 
the TOURIST message is quite specific about what is wrong. The reference 
section of this book can help you correct the problem quickly. Besides 

Part 3, “Reference Information,” you will find device-specific information in 
Part 4, “Product-Dependent Information” that relates to EREP controls. 


Storage Problems 


You must provide enough storage for EREP’s internal sort table (using the 
TABSIZE control parameter), or the program terminates. In addition, you must 
make sure the user region or virtual storage size for the job or step is big enough 
to hold the sort tables and the EREP program itself. If it is not, the EREP run 
terminates. 


Messages in the MSGCLASS (MVS only) and TOURIST output indicate if one 


of these problems occurred; the MSGCLASS output includes the completion 
codes for the steps in the job. 
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Problems Running EREP 


I/O Errors 


Incorrect Input 
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You can check the storage requirements for the system you are running EREP 
under in “VSE Storage Requirements” or “MVS Storage Requirements” and 
make corrections before trying to rrun EREP. (The VM virtual storage require- 
ments and capacities depend on the guest system and the virtual machine.) 


When EREP cannot open or close a data set, or read the input records, or write 
the output records to the EREPPT data set, you have a data management 
problem. EREP puts messages in the TOURIST output to alert you, and the 
MSGCLASS output from the job helps as well, by showing where the job ended 
and what the completion codes were. Check “VSE System Controls,” or “MVS 
System Controls,” or “Defining Files for CPEREP” for the proper data manage- 
ment information. 


When your EREP report output is not right, the chances are good that it is 
because the input records were not right. In this case, you must verify the records 
EREP used for the report. In the absence of helpful messages, the best way to do 
this is via the DEBUG option; see “The EREP DEBUG Parameter” on 

page 11-63. 


EREP input can be incorrect for one of two reasons: 
1. The system recording routines recorded the records incorrectly 


2. Something happened to the records on their way from the ERDS to another 
data set. 


The second reason is the more likely; it is also the only one you can do anything 
about directly. Losing or duplicating records is not primarily a coding problem, 
however; it is really a matter of managing your error data base for EREP. See 
“Managing Error Data” on page 3-1 for some suggestions on preventing the 
destruction or duplication of records. 


A good general-purpose way to check for missing records is to run an Event 
History report specifying DEV and TYPE to match the suspect record; the report 
will include data from every record that meets your selection criteria. Another 
way to look for a particular record is to run a Detail Edit of the record (speci- 
fying DEV, TYPE, DATE and TIME, and any other selection parameter that will 
narrow the choice).! The Detail Edit includes formatted data from the record, as 
well as a hexadecimal dump of the record itself. 


1 Not necessarily the easiest way; see “Using the DEBUG Parameter” on page 5-3. 


TOURIST Output/DEBUG Parameter 


Cc Using the TOURIST Output 


Should your EREP job not run because of a syntax or other coding error, you 
can use the TOURIST output not only to see the message about your problem, 
but also to see exactly how EREP interpreted your control statements and param- 
eters. The system control statements (JCL, for example) and the actual EREP 
controls, as you entered them, appear in the MSGCLASS output for the job. 


Figure 12-9 on page 12-12 is an example of the typical TOURIST output gener- 
ated for a single EREP report. 


EREP normally prints the TOURIST messages just before the requested report, 
so you can look at both together in case there is a problem. However, you can 
control the output class and device for the TOURIST output. For example, in an 
MVS installation, you can change the output classes for the EREPPT and 
TOURIST data sets. When things are running smoothly, you can spool the 
TOURIST output to another device so you see only the reports from the 
EREPPT device. If you do this, remember to check the TOURIST messages from 
time to time to make sure you haven't missed anything. When you are debugging 
a problem with a report or with your EREP run, and you want to see the mes- 
sages with the report, simply change the output class for the TOURIST data set 
to match that of EREPPT. 


Using the DEBUG Parameter 


If a problem with an EREP report or your EREP run is associated with an input 
record, you must be able to look at the record. You can run a Detail Edit of the 
record; but this can be complicated as you try to isolate a particular OBR record, 
for example, among many from the same device types. 


The easiest way to see the records used for an EREP report is to run an Event 
History and include the DEBUG parameter with its option 17 in the EREP con- 
trols. The records will appear, unformatted and in hexadecimal, in the report. 
See “The EREP DEBUG Parameter” on page 11-63 for coding details. 


When you have deciphered the contents of a record, you can compare it to the 
mapping of the record in Chapter 10, “Error Records for EREP,” to see if they 
match. The IBM Customer Engineer can also help you interpret the records, 
referring to the maintenance documentation for the device that generated the 
record. 
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Part 3. Reference Information 


How to Use Part 3 


This part of the EREP User’s Guide and Reference presents information in quick- 
look-up format: the syntax of EREP parameters and control statements and of 
CPEREP operands; tables and charts showing how the EREP controls go 
together and how the requirements of the operating systems differ. 


The reference information also includes mappings of the formats of the records 
EREP edits and prints, along with a brief explanation of why each record is gen- 


erated; and all the EREP messages, as they appear for each operating system. 


Use the Section Table of Contents to find specific kinds of information in Part 3; 
more details on the various topics are in the other parts of this book. 
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Chapter 6. Introduction to EREP Controls 


You communicate to EREP using keyword parameters and control statements. 


The parameters tell EREP which report to run, if any, and which records to use 
for the report, and what to do with the records when the report is complete. 


Control statements tell EREP what your hardware configuration is like: how 
many processors you have; and whether or not your I/O devices are shared by 
more than one processor; and exactly where the devices are. Control statements 
also give EREP other information, such as limits on the number of errors to be 
included in a report. 


Figure 7-2 shows the syntax for every EREP parameter; Figure 8-7 shows the 
correct format for each EREP control statement. The full descriptions of parame- 
ters and control statements are in Chapter 7, “EREP Parameters” and 

Chapter 8, “EREP Control Statements.” 


Syntax Rules and Conventions 


The following paragraphs describe the notation we have used to define the syntax 
and format of the EREP control statements and parameters. Syntax rules define 
what is required or optional for the specific purpose or process you are 
requesting. Certain rules are common to all parameters: 


e Code uppercase letters, numbers, and the set of symbols listed here EXACTLY 

as shown in the parameter/statement syntax. 

apostrophe 
asterisk - 
comma , 
equal sign = 
hyphen - 
parentheses ( ) 
period 


e Lowercase letters, and other symbols, appearing in a parameter/statement 
syntax represent variables for which you must substitute specific information. 
For example, if the word “serial” appears in the parameter/statement syntax, 
substitute a specific serial number value (012345, or 503B) for it in the actual 
parameter/statement. 
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Syntax Rules 
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We use the set of symbols listed below to define the syntax for you. You 
never use them in the actual parameter. 


underscore — 
braces { } 
brackets [ ] 
ellipses 


vertical bar | 
Here is how we use these symbols: 


— An underscore indicates a default option. If you want an underscored 
alternative, you need not specify it in the actual parameter. 


— A vertical bar represents logical OR, and means that you can code one or 


the other of two alternatives. 
For example: KEYWORD=[ALPHA| BETA] 


indicates that you can code either ALPHA or BETA as the value for 
KEYWORD. 


— Braces group related items, such as alternatives. 
For example: ALPHA=({A|B|C},D) 


indicates that you must choose one of the items enclosed within the 
braces. If you choose A, code ALPHA =(A,D). 


— Brackets also group related items; however, everything within the brackets 


is optional and may be omitted. 
For example: ALPHA=([A|B|C] ,D) 


indicates that you may choose one of the items within the brackets or 
omit all of them. If you select only D, code ALPHA =(,D). 


— An ellipsis indicates that the preceding item or group of items can be 
repeated more than once in succession. 


For example: ALPHA [,BETA] 


indicates that ALPHA can appear alone or can be followed by ,BETA 
any number of times in succession. 
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Syntax Rules 


A hyphen or dash between two entries indicates a range. Code the hyphen 
exactly where shown in the syntax. 


For example: 


hhmm-hhmm indicates a range of time. 
addr-addr indicates a range of continuous addresses. 


Alphameric characters. Unless otherwise indicated, an alphameric character is 
one of the following: 


alphabetic A-Z 


numeric 0-9 
national $# @ 
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Parameters - Introduction 


Parameter and Control Statement Layout J 


This section includes descriptions of all the EREP parameters and control state- 
ments as well as their correct syntax. The descriptions all look like this: 


Name of Parameter The shortened form; which kind of parameter it is; the full 


name. 

Tells EREP to: What it does; any related device information. 
Syntax: The format; the way it should be coded. 
Default: Description, if one exists; otherwise, “None.” 


Parameter Conflicts: Other parameters that you cannot use with this parameter. 


Coding: Any special coding rules that you must follow. 

Note(s): Brief special information about the parameter/control state- 
ment. 

Example(s): The completed parameter or control statement if not 


obvious from the syntax; otherwise, blank. 


arranged alphabetically within the two groups. You will find device-specific usage 
notes for the parameters and some control statements in Part 4, “Product- 
Dependent Information.” 


In this part of the book, the EREP parameters and control statements are ) 
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Chapter 7. EREP Parameters 


You direct EREP processing, and tailor EREP reports, using the keyword param- 
eters listed on the following pages. 


Note that none of the parameters is required; you may allow EREP to operate 
entirely by default. However, you should check the default options to be sure 
they are the ones you want. 

This reference section contains the syntax and default value for each EREP 
parameter, along with a brief description of what the parameter does, and how it 
works with other EREP controls. You will find more notes on usage in 

Part 2, “Setting Up and Running EREP” and Part 4, “Product-Dependent 
Information.” 


Figure 7-2 on page 7-41 is a summary of the correct syntax for all the EREP 
parameters. 


Coding EREP Parameters 


The same coding rules apply to all the EREP parameters. To avoid repetition, 
they are listed here rather than with each parameter. 


e Each parameter consists of a keyword followed by an equal sign and one or 
more values: 


KEYWORD=(value,value ... ,value) 
@ Some parameters require parentheses around the value field. 


@ For all of the report parameters except PRINT, and for some of the control 
parameters, you need code only the keyword; YES is implied. For example: 


SYSUM is the same as SYSUM=Y 
EVENT is the same as EVENT=Y 
HIST is the same as HIST=Y 


e@ There can be no imbedded blanks in the parameter expression or the param- 
eter field. 
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General Coding Rules 
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Use commas to separate the parameters if they are on the same line.! If you 
code the parameters as instream data, they can be entered as one record or as 
individual records: 


//SYSIN DD * 
TRENDS , HIST, ACC=N , DATE= (82032 ,82056) 
ENDPARM 


control statements 


/* 
OR 


//SYSIN DD * 
TRENDS 

HIST 

ACC=N 

DATE= (82032,82056) 
ENDPARM 


control statements 
/* 


If you enter the parameters as instream data and you are also entering EREP 
control statements, the parameters must precede the control statements and be 
followed by ENDPARM. 


When entering parameters as CPEREP operands, you can separate them by commas 
or one or more blanks. 


J 


Using Comments 


General Coding Rules 


@ When you run EREP under a VSE system, you must enter the parameters as 
instream SYSIPT data following the EXEC statement: 


// EXEC IFCEREP1 
EVENT , DATE= (82330-83015) , HIST, ACC=N 
ENDPARM 


7* 


OR 


// EXEC IFCEREP1 
EVENT 

DATE= (82330-83015) 
HIST 

ACC=N 

ENDPARM 

os 


Note: ENDPARM is the delimiter EREP looks for between parameters and 
control statements, when the parameters are entered as instream data. 


e When you run EREP under an MVS system, you code the parameters either 
as instream (SYSIN) data with the EREP control statements, or on the JCL 
EXEC statement, as 


PARM= ' keyword = value,keyword=value' . 


— If you put the parameters on the EXEC statement, and they include 
special characters (for example, =), you must enclose each parameter 
expression in single apostrophes or parentheses. 


— If the parameters are continued to another line, you must enclose the 
entire field in parentheses. For example: 


//STEP1 EXEC PGM=IFCEREP1,PARM=('PRINT=PS','TYPE=IE', 
// 'ACC=N' , HIST) 


See the JCL manual for your MVS system for more details on coding the 
PARM parameter. 


You provide documentation of your EREP jobs in comments, identified by an 
asterisk (*) in the first column of the input record. 


Your comments appear in the TOURIST output. See “DASDID Control 


Statement” on page 8-7 for examples of using comments to document your EREP 
controls. 
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Selection Parameters for EREP Reports 
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You can use both selection and processing parameters for EREP reports. With 
very few exceptions, all the processing parameters can be combined with any of 
the report parameters. The selection parameters, however, are less straightfor- 
ward. Even though most of them are valid with all the report parameters, many 
are not meaningful for a given report. 


Figure 7-1 shows which selection parameters you can and cannot use for the 
various EREP reports. The descriptions in the rest of this chapter give more 
detailed information about the relevance of each selection parameter to the EREP 
reports. 


SELECTION PARAMETERS 





REPORT 
PARAMETERS 


ou-wowwam 
ZzzwmHo 
mu~«<s 
























































Figure 7-1. Selection Parameters for EREP Reports 
Notes: 
1. The following devices are allowed: 3410, 3420, 8809, 34XX. 


See Figure 12-1 on page 12-2 for incorrect combinations of selection and proc- 
essing parameters. 


2 This is true for EREP 3.3 and later releases; if you are running EREP 3.2 or an 
earlier release, more selection parameters are actually invalid for use with some 
report parameters. See Chapter 12, “Summary of Tables and Charts.” 
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C Parameter Descriptions 


ACC 


Accumulate Records 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


ACC Parameter 


(Processing Parameter) 


Copy the records that passed filtering for the report onto 
an output data set. 


ACC|=Y]|=N 


If you omit this processing parameter, EREP assumes 
ACC=Y, except when you request a Threshold report. 
Then, the default is ACC=N. 


Specifying ACC is the same as ACC=Y. 


DEVSER 
THRESHOLD 


e When you use or imply ACC=Y for an EREP run, 
you must also code the system control statement(s) 
needed to define the output data set that will hold 
the records. This 1s described in the “System Con- 
trols” sections of Part 2, “Setting Up and Running 
EREP.” 


e EREP does not zero the ERDS unless all the records 
have been accumulated on an output data set. See 
the ZERO parameter for more details. 


e If you code ZERO=Y when requesting PRINT =SU 
or PRINT =NO, EREP assumes ACC=Y and 
expects you to define the output data set. 


e If you run a System Summary report with LOGREC 
as input and allow ACC to default, EREP also 
assumes ZERO=Y. This is not a problem unless 
you have coded ACCDEV as a dummy data set 
(MVS only). In that case, the records are lost. 
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CPU Parameter 


CPU 


Central Processing Unit (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 
Coding: 


Parameter Conflicts: 


Note(s): 


Example(s): 
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Use only the records containing the model and serial 
numbers you specify on this parameter for the requested 
report. The model number is the machine type. 


The valid processor model numbers for the CPU param- 
eter are: 


0115 0125 0135 0138 0145 0148 O155 0158 
0165 0168 3031 3032 3033 3052 3062 3081 
3083 3084 3090 4321 4331 4341 4361 4381 
9081 9083 9373 9375 9377 


CPU =(serial.modell,serial.model| ... ) 
serial is the six-digit decimal processor serial number. 


model is the four-digit decimal processor model 
number. 


Maximum of six entries. 

EREP processes records from all processors. 

No special considerations. 

CPUCUA 

MOD 

THRESHOLD 

ZERO 

If you use the CPU parameter, you cannot use 
ZERO=Y because you have excluded some records from 


processing. 


CPU=(123456.0168, 234567. 3081) 


CPUCUA 


CPUCUA Parameter 


CPU/Channel/[Unit Address (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Select for the requested report only the records from the 
specified unit addresses associated with the specified 
processors. 


CPUCUA = (serial.{cua|cuX}|,serial.{cua|cuX}] ... ) 


serial is the six-digit decimal CPU (processor) serial 
number. 


cua is a unique three- or four-digit hexadecimal 
channel/unit address (in a 370/XA environment, 
it is the device number). 


cuX is two or three hexadecimal digits followed by an 
X to denote the range of device addresses with 
those digits ending in 0 through F. 


Maximum of four entries. 
EREP processes all available records. 
No special considerations. 


CPU 

CUA 
DEVSER 
MOD 
THRESHOLD 
ZERO 


e If you use the CPUCUA parameter, you cannot use 
ZERO=Y because you have excluded some records 
from processing. 


e CPUCUA only affects the selection of record types 


(TYPE Parameter) that contain a CUA: CCH, DDR, 
MIH, OBR, and MDR. 
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CUA Parameter 


CUA 


Channel/Unit Address (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 
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Select for the requested report only the records related to 
the specified channel and or/unit addresses. 


CUA = ({addr|addr-addr}|,addr|addr-addr| . . . ) 


addr is a three- or four-digit hexadecimal address 
or group of addresses. The format of the 
address may be nnXX, nnnX, or nnnn (for 
example, 01XX, 038X, or 049C). nnXX 
means that EREP processes all controller/unit 
addresses on channel ‘nn’; nnnX means that 
EREP processes all unit addresses on 
channel/control unit ‘nnn’. 


Note: The channel identifier can be one or 
two digits. Reports produced by 
EREP 3.2 show four-digit device 
addresses. 


addr-addr is a range of contiguous hexadecimal 
addresses, which may include more than one 
channel and control unit. The lower address 
must appear first in the expression. 


Maximum of eight entries. 
EREP processes records from all devices (CUAs). 
No special considerations. 


CPUCUA 
ZERO 


e If you use the CUA parameter, you cannot use 
ZERO=Y because you have excluded some records 
from processing. 


e CUA only affects the selection of record types 
(TYPE parameter) that contain a CUA: CCH, 
DDR, MIH, OBR, and MDR. 


e If there are alternate paths to a device, and you want 
EREP to process all the records for the device, you 
must specify the CUAs for all the alternate paths. 


CUA Parameter 


Example(s): CUA=(012C) 
CUA=(0123,032X,04Xx) 


CUA=(123-320,4B0-COO) 
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DATE Parameter 


DATE 


Date Range (Selection Parameter) 
Tells EREP to: Select records created during the specified date range. 
Syntax: DATE = (vyddd| {3} yyddd]) 

yyddd_ is the year (yy) and the Julian day (ddd). 


The first yyddd is the year and day when the 
date range begins; the second yyddd is the ending 
year and day. The second date is optional; you 
can select records from a single date as well as 
from a range of dates. To select a single date, 
code only one yyddd. 


When you code a date range, the second yyddd 
must be equal to or greater than the first. If it is 
not, EREP issues a syntax-error message. 


Default: None. 
Except for the Trends report. For the Trends report, the 
default if you do not code the DATE parameter is to 


process 30 days of error data. 


Parameter Conflicts: ZERO 


Note(s): 
e DATE is valid with all the report parameters. 
e Ifyou use the DATE parameter, you cannot use 
ZERO=Y because you have excluded some records 
from processing. 
e To express a range of 30 days, add 29 to the begin- 
ning Julian day. 
e DATE is required when you use the TIME selection 
parameter. 
Example(s): DATE= (82137) 


DATE= (82136,82143) 


DATE= (83152-83182) 
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DEV 


DEV Parameter 


Device Type (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Select — or exclude — records associated with the speci- 
fied generic device type(s). 


The valid device types for DEV are: 


1012 1015 1017 41018 1030 1050 1052 
1053 1060 1130 115A 1255 1270 1275 
1285 1287 1288 1403 1419 1442 1443 
2020 2150 2250 2260 2265 2280 2282 
2301 2303 2305 2311 2314 2321 2400 
2495 2501 2520 2540 2560 2596 2671 
2701 2702 2703 2715 2740 2741 2760 
2770 2780 2790 2930 2947 2955 2956 
2970 2972 3036 3066 3138 3148 3158 
3168 3203 3210 3211 3213 3215 3262 
3277 3278 3284 3286 3289 3310 3330 
3340 3350 3370 3375 3380 3410 3420 
3430 3480 3504 3505 3525 3540 3670 
3700 3704 3705 3725 3735 3791 3800 
3838 3848 3850 3851 3886 3890 3895 
3945 3968 4245 4248 5080 5203 5424 
5425 7340 7443 7770 7772 83B3 8809 
9332 9335 9347 BAOO CTCA 


The valid general device classes for DEV are: 


23XX 27XX 32XX 33XX 34XX 37XX 38XX 

DEV =(type|Ntypel,type|Ntype] . . . ) 

type isa four-digit hexadecimal number: either a specific 
device type (3340, 3420) or the representation of a 
class of devices (33XX, 34XX, and so on). 


N indicates “not”; excludes a device type from the 
report. 


Maximum of eight entries. 
EREP processes records associated with all device types. 


The device type number(s) must be enclosed in paren- 
theses. 


ZERO 


See Figure 12-1 on page 12-2 and Part 4, “Product- 
Dependent Information” for some special restrictions. 
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DEV Parameter 
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Note(s): 


Example(s): 


If you use the DEV parameter, you cannot use 
ZERO=Y because you have excluded some records 
from processing. 


The only record types affected by the DEV param- 
eter are the following: DDR (D), MIH (H), OBR 
(O) and MDR (T). Even though they contain a 
device code, CCH and SLH records cannot be 
selected by device type. 


If a device is emulating another device, use the device 
type number of the emulated device on the DEV 
parameter. 


You cannot select and exclude devices on the same 
DEV parameter; DEV = (3330,N2400) is invalid. 
You can, however, code more than one DEV param- 
eter. 


EREP interprets some DEV entries to mean more 
than just the device you have coded; see 

Part 4, “Product-Dependent Information” for addi- 
tional device-specific considerations. 


To select records from specific devices or a class of 
devices: 


DEV= (3420) 


DEV=(33XX,3705) 


To exclude the records from specific devices or a class of 
devices: 


DEV=(N3420) 


DEV=(N33XX,N3705) 


A 


DEVSER 


DEVSER Parameter 


Device Serial Number (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Select for the Threshold Summary only those OBR 
records that contain the specified device serial number(s). 
See the notes that follow for more information about the 
device serial number. 


DEVSER = (seriall serial] . . . ) 


serial isa six-digit decimal device serial number from 
the service data. See “34XX Tape Devices” in 
Part 4, “Product-Dependent Information” for 
the devices to which DEVSER applies. 


Maximum of eight entries. 


EREP selects OBR records without regard for the device 
serial numbers they contain. 


No special considerations. 


ACC 
CPUCUA 
ERRORID 
EVENT 
LIA/LIBADR 
MOD 
PRINT 
SHORT 
SYMCDE 
SYSEXN 
SYSUM 
TERMN 
TRENDS 
ZERO 


See Figure 12-1 on page 12-2 and “34XX Tape Devices” 
on page 17-4 for some special restrictions. 


e DEVSER is used only for the Threshold Summary 
report. 


e DEVSER is valid with all the EREP processing 
control parameters except ACC and ZERO. 


e EREP forces the DEV and TYPE parameters when 
you use the DEVSER parameter. See “34XX Tape 
Devices” in Part 4, “Product-Dependent 
Information.” 
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DEVSER Parameter 


@ The device serial number is a value in a two-byte | 
field of a tape OBR record that should correspond to J 
the external serial number of the device. If the 
external serial number is greater than 65535, only the 
four low-order digits (decimal) are correct for the 
device serial. To use DEVSER to specify numbers 
larger than 65535, do the following: 


1. Convert the external serial number to binary 

2. Reconvert the low-order (rightmost) 16 bits to 
decimal 

3. Pad the resulting number with leading zeros to 
make a six-digit decimal number. 


Example(s): DEVSER=(013455,113455,213455) 
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C 


ERRORID 


ERRORID Parameter 


Error Identifier (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Select for the requested report only the records con- 
taining the specified error identifier. 


ERRORID = (seqno|,cpuid,asid,hh,mm,ss,t]) 


seqno is a five-digit decimal error identifier from an 
MCH record or an MVS software (SFT) record. 


cpuid is a two-digit hexadecimal processor (CPU) identi- 
fier. 


asid is a four-digit hexadecimal address space identi- 
fier. 


hh is a two-digit decimal value representing the hour. 


mm is a two-digit decimal value representing the 


minute. 

SS is a two-digit decimal value representing the 
second. 

t is a single decimal digit indicating tenths of the 
second. 


EREP processes all MCH and SFT records, regardless of 
their error identifiers. 


No special considerations. 


DEVSER 
THRESHOLD 
ZERO 


e If you use the ERRORID parameter, you cannot use 
ZERO=Y because you have excluded some records 
from processing. 


e The only records that contain an ERRORID are 
MCH records and software (SFT) records produced 
by MVS. Therefore, the only record TYPE values 
you can code with ERRORID are M and S. 


e Coding only the sequence number (seqno) causes 
EREP to process all records with the same 
ERRORID, regardless of when or where they were 
recorded. 
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ERRORID Parameter 


e If you code the time-stamp values on the ERRORID 
parameter, you must also code the DATE parameter. J 


Example(s): ERRORID=(01234) 


ERRORID=(23456,01,0012,06,21,31,6) 
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EVENT 


EVENT Parameter 


Event History (Report Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 
Parameter Conflicts: 


Note(s): 


Produce an Event History report — one-line abstracts of 
selected records, in chronological order. 


EVENT|=Y]|=N 


Unless you specifically code EVENT or EVENT =Y, 
EREP does not produce an Event History report. 


Specifying EVENT is the same as EVENT =Y. 
DEVSER 

If you do not code any selection parameters with 
EVENT, EREP processes all available records for the 
report. However, the default value for the ZERO param- 


eter is still NO; EREP does not clear the ERDS unless 
you specifically request it. 
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HIST Parameter 


HIST 
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History Input (Processing Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Use the records in a history data set for the requested 
report, instead of those in the ERDS. 


HIST[=Y]| =N 


If you omit this processing parameter, EREP assumes 
HIST=N and uses the ERDS as input. 


Specifying HIST is the same as HIST=Y. 


MERGE 
ZERO 


e HIST is valid for all the report parameters. 


@ When you use the HIST parameter, you must also 
code the system control statements needed to define 
the input data set that holds the records, and a tem- 
porary work data set. See Figure 1-9 on page 1-15 
and your “System Controls” section in 
Chapter 4, “Running EREP.” 


e If you do not use the HIST (or MERGE) parameter, 
you are telling EREP that the ERDS 1s its input. 


e When running EREP under an MVS system, you can 
use more than one data set as the history input; just 
concatenate DD statements for the other data sets to 
the ACCIN DD statement. In VSE systems, the 
history input must be on a single data set. 


C 


LIA/LIBADR 


LIA/LIBADR Parameter 


Line Interface Base Address (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Select MDR records according to the specified line inter- 
face base address. See Chapter 22, “Teleprocessing (TP) 
Devices” in Part 4, “Product-Dependent Information.” 


{LIA| LIBADR} = address 


address is a four-digit hexadecimal line interface base 
address. 


EREP processes all available records. 
No special considerations. 


DEVSER 
SYMCDE 
TERMN 
THRESHOLD 
VOLID 

ZERO 


See Figure 12-1 on page 12-2 and Part 4, “Product- 
Dependent Information” for some special restrictions. 


@e You can use LIA or LIBADR; EREP accepts both 
forms. 


e If you use the LIA/LIBADR parameter, you cannot 
use ZERO=Y because you have excluded some 
records from processing. 


e EREP assumes you want records from a 3705 or 
3725 communications controller when you use the 
LIA/LIBADR parameter, so coding the DEV param- 
eter with any other device number causes a param- 
eter conflict. See Chapter 22, “Teleprocessing (TP) 
Devices” in Part 4, “Product-Dependent 
Information.” 
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LINECT Parameter 


LINECT 
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Line Count (Processing Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Print this many lines on each page of output. 
LINECT =nnn 

nnn is one to three decimal digits. 
Minimum value is 25. 


For VSE systems, the number of lines set for SYSLST at 
SYSGEN. 


For MVS and VM systems, 50 lines per page. 
No special considerations. 
PRINT =NO 


If the value you specify for LINECT is less than 25, 
EREP ignores it and uses the default value instead. 


= MERGE 


¢C* 


MERGE Parameter 


Merge Input Data Sets (Processing Parameter) 


Tells EREP to: Use the records from both the ERDS and a history data 
set as input for the requested report. 

Syntax: MERGE|= Y]/=N 

Default: If you omit this processing parameter, EREP assumes 
MERGE=N and uses records from only one input data 
set. 

Coding: Specifying MERGE is the same as MERGE=Y. 


Parameter Conflicts: HIST 
Note(s): 


e When you use the MERGE parameter, you must 
also make sure the system control statements needed 
to define both of the input data sets are present or 
accounted for. See Figure 1-9 on page 1-15. 


e If you do not use the MERGE (or HIST) parameter, 
you are telling EREP that the ERDS is its only 


input. 


e Under MVS, the history input can be in more than 
one data set. See “HIST” on page 7-18. 
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MOD Parameter 


MOD 


Processor Model (Selection Parameter ) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Example(s): 
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Select for the requested report only those records con- 
taining the specified CPU (processor) model number(s). 


The valid processor model numbers for the MOD param- 
eter are: 


0115 0125 0135 0138 0145 0148 0155 
0158 0165 0168 3031 3032 3033 3052 
3062 3081 3083 3084 3090 4321 4331 
4341 4361 4381 9081 9083 9373 9375 
9377 


MOD =(modell,model] ... ) 


model is a three- or four-digit decimal processor model 
number. 


Maximum of four entries. 


EREP processes records regardless of which kind of 
processor they were created on. 


No special considerations. 


CPU 
CPUCUA 
DEVSER 
THRESHOLD 
ZERO 


@e MOD is the processor equivalent of the DEV param- 
eter. 


e If you use the MOD parameter, you cannot use 
ZERO=Y because you have excluded some records 


from processing. 


MOD=(168, 3031) 


C MODE 


MODE Parameter 


Operating Mode (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Select for the requested report only those records created 
while the system was operating in the specified mode. 


MODE = {370|370XA|ALL} 

370 means 370 mode only. 

370XA means 370-XA mode only. 

ALL means both 370 and 370-XA mode. 


If you omit this selection parameter, EREP assumes 
MODE=ALL and processes all available records, 
regardless of the mode they were recorded in. 


No special considerations. 
None. 


See Figure 12-1 on page 12-2 and Part 4, “Product- 
Dependent Information” for some special restrictions. 


e ZERO=Y is valid only with MODE=ALL. 


e If EREP is running under any MVS system except 
MVS/XA, it treats software (SFT) records produced 
by MVS/XA as unknown records. Therefore, the 
combination of MODE=370XA or MODE=ALL 
and TYPE =S is meaningful only if the records were 
produced by MVS/XA. 


e If you code MODE=370 and TYPE=C, EREP 
processes CCH records; if you code MODE=370XA 
and TYPE=C, EREP processes SLH and CRW 
records. Code MODE=ALL and TYPE=C to 
select all available CCH, SLH, and CRW records for 
the report. 


e Ifa device is supported in 370-XA mode, any Detail 
Summary reports you request for the device will 
reflect that mode, regardless of what you specify on 
the MODE parameter. 
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PRINT Parameter 


PRINT 
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Detail Print Reports (Report Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Parameter Conflicts: 


Coding: 


Note(s): 


Produce the Detail PRINT report(s) specified; or 
(PRINT = NO) to produce NO printed report output. 


PRINT = {AL|/DR|NO|PS|PT|SD|SU} 


AL requests all the Detail PRINT reports: Detail Edits 
of the records, Detail Summaries, and, if applicable, 
Data Reduction reports. 


DR requests only Data Reduction reports. 
NO requests that no reports be printed at all. 


PS requests both Detail Edit and Detail Summary 
reports. 


PT requests only Detail Edit reports. 


SD requests Detail Summaries and Data Reduction 
reports. 


SU requests only Detail Summary reports. 


If you do not code any report parameter at all, EREP 
assumes PRINT =SD, which produces a Detail Summary 
and, if applicable, a Data Reduction report for each 
record and device type you select. If you code PRINT 
without any keyword value, it is a syntax error. 


DEVSER 


You cannot code PRINT alone; it requires one of the 
report designations (AL, PT, SU, and so on) as well. 


@e PRINT=SD is the default report parameter for all 
EREP processing. The only way to avoid getting 
any printed report output is to code PRINT = NO. 


@ The default value for the ZERO parameter with 
PRINT is NO; EREP does not clear the ERDS 
unless you specifically request it. If you use selection 
parameters with PRINT, you cannot clear the 
ERDS, because not all the records have been proc- 
essed for the report. 


2 


PRINT Parameter 


e If you code ZERO=Y and either PRINT=NO or 
PRINT =SU, EREP assumes ACC =Y as well; make 
sure the ACCDEV output data set is present to 
receive the accumulated records. 


@ See Part 4 for product-specific notes about the 
PRINT parameter. 
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SHORT Parameter 


SHORT 
Print Short OBR Records (Processing Parameter) 
Tells EREP to: Include short OBR records in a requested Detail Edit or 
Summary (PRINT) report. 
Syntax: SHORT[= Y]| =N 
Default: If you omit this processing parameter, EREP assumes 


SHORT =N and suppresses the detail printing of short 
OBR records. 


Coding: Specifying SHORT is the same as SHORT =Y. 
Parameter Conflicts: DEVSER 

PRINT=DR 

PRINT =SD 
Note(s): The OBR Detail Summary always includes the informa- 


tion in short OBR records. 
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Cc 


SYMCDE 


SYMCDE Parameter 


Fault Symptom Code (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Example(s): 


Select for the requested report only those 33XX DASD 
records having the specified fault symptom code. The 
symptom code consists of the bit settings in a two-byte 
field of the sense data in an OBR record for a 33XX 
DASD. 


The combination of digits and Xs on the parameter indi- 
cate how specific you are being: if you code 4032, you 
want EREP to select only the records containing that 
exact symptom code; if you code 40XX, you want EREP 
to select the records containing symptom codes that 
begin with 40. 


SYMCDE = {nnnn|nnnX|nnXX|nXXX} 
n isa hexadecimal digit 
X is the character X. 


EREP processes 33XX records regardless of their 
symptom code bit settings. 


No special considerations. 


DEVSER 
LIA/LIBADR 
TERMN 
THRESHOLD 
VOLID 

ZERO 


If you use the SYMCDE parameter, you cannot use 
ZERO=Y because you have excluded some records from 
processing. 


Following are some ways to code SYMCDE, and the 
resulting bit setting EREP looks for in the OBR sense 
data. 


Parameter Bit 

Value Setting 
SYMCDE=4032 0100 0000 0011 0010 
SYMCDE=193X 0001 1001 0011 xxxx 
SYMCDE=92XX 1001 0010 xxxx xxxx 
SYMCDE=9XXX 1001 xxxx XXXX XXXX 


“x” indicates either a “O” or “1” is valid. 
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SYSEXN Parameter 


SYSEXN 
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System Exception Reports (Report Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Produce the System Exception report series — several 
reports covering various aspects of your processing and 
I/O subsystems. 


SYSEXN| = Y]| =N 


Unless you specifically code SYSEXN or SYSEXN=Y, 
EREP does not produce a System Exception report 
series. 


Specifying SYSEXN is the same as SYSEXN=Y. 


DEVSER 


e See Part 4, “Product-Dependent Information” for 
device-specific information about the System Excep- 
tion report series. 


e Unless you use DATE and/or TIME with SYSEXN, 
EREP processes all the available records. 


e The default value for the ZERO parameter with 
SYSEXN is NO; EREP does not clear the ERDS 
unless you specifically request it. 


e EREP requires a large internal sort table to create 
the System Exception reports; 512K is not an unrea- 
sonable TABSIZE value. The increase in TABSIZE 
will probably require a corresponding increase in the 
virtual storage (partition or region size) available to 
EREP. See the sections entitled “Storage Require- 
ments” in Chapter 4, “Running EREP.” 


e You need the DASDID and LIMIT control state- 
ments for System Exception reports. See 
Chapter 8, “EREP Control Statements.” 


C 


SYSUM 


SYSUM Parameter 


System Summary (Report Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Produce a System Summary — a comprehensive report of 
errors for each of your system’s principal elements: 
CPU/Channel/Subchannel/Storage/SCP, and I/O sub- 
system. 


SYSUM|[=Y]]=N 


Unless you specifically code SYSUM or SYSUM=Y, 
EREP does not produce a System Summary. 


Specifying SYSUM is the same as SYSUM=Y. 


DEVSER 


e If you do not restrict record selection by date and/or 
time, and the input records are on the ERDS, the 
default value for both ACC and ZERO is YES when 
you request a System Summary: EREP accumulates 
the records to an output (ACCDEV) data set and 
zeroes the ERDS unless you tell it otherwise. 


e If you have coded the ACCDEV data set as 
DUMMY, the records from the ERDS are discarded. 
If there is no DD statement for ACCDEV, EREP 
abends. 
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TABSIZE Parameter 


TABSIZE 
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Sort Table Size (Processing Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Use a sort table of the specified size to process the 
records selected for the report. 


The sort table is EREP’s internal work space, where it 
arranges the records into the order required for a given 
report. 

TABSIZE = nnnK 

nnn is a one-, two-, or three-digit decimal number. 

K means the value is in thousands of bytes. 

For VSE systems, 4K bytes. 

For MVS systems and VM, 24K bytes. 


No special considerations. 


None. 


@ For all reports except the System Exception series, 
each LK (1024 bytes) of table size holds approxi- 
mately 100 entries. For System Exception reports, 
each IK of table size holds approximately 20 entries. 


e If you increase the table size for an EREP run, you 
probably will need to increase the partition or region 
size accordingly. See the sections on storage require- 
ments in Chapter 4, “Running EREP.” 


C 


TERMN 


TERMN Parameter 


Terminal Name (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Example(s): 


Select for the requested report only those TCAM and 
VTAM OBR records that contain the specified terminal 
name. 


VTAM OBR records are created only for local teleproc- 
essing devices. The terminal name in these records is the 
NCP, or major node name. Remote attached TP devices 
produce only MDR records, which contain the minor 
node name. See Chapter 22, “Teleprocessing (TP) 
Devices” in Part 4, “Product-Dependent Information” 
for the devices to which this parameter applies. 


TERMN = name 


name is the valid one- to eight-character alphameric 
name assigned to a particular terminal. 


EREP processes TCAM and VTAM OBR records 
regardless of the terminal name they contain. 


No special considerations. 


DEVSER 
LIA/LIBADR 
SYMCDE 
THRESHOLD 
VOLID 

ZERO 


e If you use the TERMN parameter, you cannot use 
ZERO=Y because you have excluded some records 
from processing. 


e Although TERMN applies only to TCAM and 
VTAM OBR records, EREP will process other types 
of records for the report unless you also code the 
appropriate DEV value and TYPE=O. See 
Chapter 22, “Teleprocessing (TP) Devices.” 


TERMN=TOO1 


TERMN=TERMOO025 


EREP Parameters 7-3] 


THRESHOLD Parameter 


THRESHOLD 


Threshold Summary (Report Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 
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Produce a Threshold Summary for your supported tape 
devices. The report is to include only those records with 
read/write error counts equal to or greater than the 
values specified on the parameter. 


THRESHOLD = (xxx,yyy) 


xxx 1s the one- to three-digit decimal (leading zeros not 
required) threshold value for temporary read errors. 
Maximum value is 255. 


yyy is the one- to three-digit decimal (leading zeros not 
required) threshold value for temporary write 
errors. Maximum value is 255. 


Unless you specifically code THRESHOLD and some 
threshold values, EREP produces no Threshold 
Summary. 


You cannot code THRESHOLD alone; you also need 
the threshold values on the parameter. 


ACC 

CPU 
CPUCUA 
DEV = (anything except 3410 or 3420 or 8809) 
ERRORID 
LIA/LIBADR 
MOD 
SHORT 
SYMCDE 
TERMN 
TYPE 

ZERO 


e If you do not specifically code DEV = (3410) or 
DEV = (3420) or DEV = (8809), EREP processes 
records from all three device types. 


e The Threshold Summary uses only OBR and MDR 
records; you cannot select records by type. 


e You cannot code ACC=Y with THRESHOLD; 
EREP assumes ACC =N for this report. 


THRESHOLD Parameter 


e Also, you cannot code ZERO=Y with 
THRESHOLD; not all the records are used for the 
report, so EREP will not clear the ERDS even if you 
request it. 


e For this report, EREP accumulates STARTIO (SIO) 
counts for records flagged as demount records. 


Example(s): THRESHOLD=(1,5) THRESHOLD=(005,015) 
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TIME Parameter 


TIME 
~# 


Time Range (Selection Parameter) 


Tells EREP to: Select only those records created during the specified 
time period. 


Syntax: TIME = (Ahmm{3}hhmm) 


hhmm is a valid time period, hours and minutes. 


Default: EREP selects records regardless of when they were 
created. 

Coding: You must always code DATE when you are coding 
TIME. 


Parameter Conflicts: ZERO 
Note(s): 


e If you use the TIME parameter, you cannot use 
ZERO=Y because you have excluded some records 
from processing. 


@e You code “hhmm” using a 24-hour clock (for | 
example, 1400 for 2:00 P.M.). J 


e Ifthe second hhmm value is greater than or equal to 
the first, the time interval pertains to each day of the 
date range specified on the DATE parameter. For 
example: 


DATE= (76001,76003) , TIME=(1000,1100) 


tells EREP to select records from 10:00 to 11:00 on 
each of three successive days. 


e Ifthe second hhmm value is less than the first, EREP 
assumes that the time interval crosses a day 
boundary. The interval is then regarded as two sub- 
intervals, one ending at 2400 and the other beginning 
at 0000. For example: 


DATE= (76001-76003) , TIME=(1100-1000) 


tells EREP to select records from 11:00 to 24:00 on 
day 76001; from 0:00 to 10:00 and 11:00 to 24:00 on 
day 76002; and from 0:00 to 10:00 on day 76003. 
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C 


TRENDS 


TRENDS Parameter 


Trends Report (Report Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Produce a Trends report — a day-by-day presentation of 
the same information that appears in the System 
Summary. 


TRENDS| = Y]/ =N 


Unless you specifically code TRENDS or TRENDS=Y, 
EREP produces no Trends report. 


Specifying TRENDS is the same as TRENDS=Y. 


DEVSER 


e If you request a Trends report without specifying a 
date range on the DATE parameter, EREP processes 
the last 30 days of data, ending with the current date. 


e If you do specify a date range, it cannot exceed 30 
days. 


e The default value for the ZERO parameter with 


TRENDS is NO; EREP does not clear the ERDS 
unless you specifically request it. 
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TYPE Parameter 


TYPE 
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Record Type (Selection Parameter) 


Tells EREP to: 


Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


That you want EREP to select only the specified type(s) 
of records. 


TYPE =code|code] .. . 
code is one of the following: 
Code Record Type 


A Al through AF records. 

B B1 through BF records. 

Cc CCH/CRW/SLH: Channel check/channel 
report word/subchannel logout records 

D DDR: Dynamic device reconfiguration 

records 

System Termination (EOD): End of day 

and other terminating events 

FO through FF records. 

MIH: Missing interrupt records 

System Initialization (IPL): Initial 

program load 

MCH: Machine check records 

OBR: Outboard records; unit checks 

Software (SFT): System abends and other 

software events. 

MDR (formerly TPR): Miscellaneous data 

records. 

CO through CF records. 

DO through DF records. 

EO through EF records. 


4 woz “27 


N <x 


EREP uses all types of records for the report. 


You do not include either parentheses or commas when 
coding TYPE. 


THRESHOLD 
ZERO 


See Figure 12-1 on page 12-2 and Part 4, “Product- 
Dependent Information” for some special restrictions. 


J 


Note(s): 


Example(s): 


TYPE Parameter 


e@ Care should be taken when specifying TYPE with 
SYSUM or SYSEXN as report results could be mis- 
leading. 


e If you use the TYPE parameter, you cannot use 
ZERO=Y because you have excluded some records 
from processing. 


@ Some other EREP selection parameters are mean- 
ingful with only some of the record types. The fol- 
lowing table shows these parameters and the 
record-type codes they work with: 


Parameter Record Types 
CPUCUA C, D, H, O, T 
CUA C, D, H, O, T 
DEV D, H, O, T 
DEVSER O 

ERRORID M,S 
LIA/LIBADR T 

SYMCDE O 

TERMN O 

VOLID O, T 


However, coding these selection parameters by them- 
selves does not fully limit the types of records EREP 
processes; you need the TYPE parameter as well, to 
improve EREP’s processing efficiency. 


For example, if you want a report using CCH 
records selected by CPUCUA, you must code 
TYPE =C as well as the CPUCUA parameter. Oth- 
erwise, EREP will use all the record types that 
contain a CPUCUA — DDR, MIH, MCH, OBR, 
and MDR, as well as CCH. 


e If you use the TYPE selection parameter, EREP does 
not process records that are truncated, invalid, or 


unknown. 


To select machine-check and channel-check records: 


TYPE=MC 


To select all software-generated records: 


TYPE=EIS 
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VOLID Parameter 


VOLID 


Volume Identifier (Selection Parameter) 


Tells EREP to: Select only those DASD and tape records associated with 
the specified volume identifier(s). 


Syntax: VOLID = (olser|,volser| ... ) 
volser isa valid volume identifier (or serial number) 
that can be from one to six alphameric characters 
long. 


Maximum of four entries. 


Default: EREP selects DASD and tape records regardless of their 
volume identifiers. 


Coding: No special considerations. 


Parameter Conflicts: LIA/LIBADR 


SYMCDE 
TERMN 
ZERO 
See Figure 12-1 on page 12-2 and Part 4, “Product- , 
Dependent Information” for some special restrictions. J 
Note(s): 
e VOLID is meaningful only for devices providing 
volume serial numbers. 
e If you use the VOLID parameter, you cannot use 
ZERO=Y, because you have excluded some records 
from processing. 
@ When you are using VOLID for a Threshold 
Summary, EREP assumes you want to see records 
from all your 34XX tape devices unless you specif- 
ically code DEV = (3410) or DEV = (3420) or 
DEV = (8809). 
Example(s): VOLID=(TPONE,TPE2,) ,DEV=(3420) , THRESHOLD=(01,15) 


VOLID=(TAPE5,CLPACK) , PRINT=PS 
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ZERO 


ZERO Parameter 


Clear the ERDS (Processing Parameter) 


Tells EREP to: 
Syntax: 


Default: 


Coding: 


Parameter Conflicts: 


Note(s): 


Erase all the records from the error-recording data set. 
ZERO|[= Y]| =N 


Unless you specifically code ZERO or ZERO=Y, EREP 
does not clear the ERDS. However, see the notes for 
exceptions to this rule. 


Specifying ZERO is the same as ZERO=Y. 


CPU 
CPUCUA 
CUA 

DATE 

DEV 
DEVSER 
ERRORID 
HIST 
LIA/LIBADR 
MOD 

MODE? 
SYMCDE 
TERMN 
THRESHOLD 
TIME 

TYPE 

VOLID 


See Figure 12-1 on page 12-2 and Part 4, “Product- 
Dependent Information” for some special restrictions. 


e There are a few circumstances under which EREP 
does not clear the ERDS even when you code 
ZERO=Y. They are: 


— If an overflow occurs in the sort table or work 
data set. 

— If you coded ACC=Y, but the output data set 
cannot be opened. 

— If you coded ACC=Y, but EREP could not 
process all the records because of table overflow. 


e If you request a System Summary report using the 
ERDS as input and code ACC =Y or allow it by 


3 Exception: MODE= ALL, which indicates no record selection. 
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ZERO Parameter 
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default, EREP clears the ERDS even if you code 
ZERO=N. If your EREP run defines the ACCDEV ; 
data set as “DUMMY,” the records will be lost. 


ZERO does not erase machine-check and channel- 
check frame records from the ERDS; they are pre- 
served until the data set is reinitialized. 


If you code ZERO=Y when requesting PRINT =SU 
or PRINT = NO, EREP assumes ACC = Y and 
expects you to define the output data set. 


Parameter Syntax Summary 


C Syntax Summary for EREP Parameters 


ACC[=Y]|=N 
Default exception: THRESHOLD 


CPU =(serial.modell,serial.model] ...) 
Maximum of 6 entries. 


CPUCUA =(Sserial.addr|,serial.addr| ... ) 
Maximum of 4 entries. 


CUA =(entry[,entry] ... ) 
Maximum of 8 entries. 


DATE = (yyddaj{;}yyddal) 
Single date or date range. 


DEV =(typel,type] . . . ) 
Maximum of 8 entries. 


DEVSER = (seriall,serial] ...) 
Maximum of 8 entries. 


ERRORID =(seqno|,cpuid,asid,hh,mm,ss,t]) 
EVENT[= Y]|=N 

HIST[= Y]| =N 

LIA|LIBADR = address 

LINECT =nnn 

MERGE| = Y]/=N 


MOD =(modell,model] . . . ) 
Maximum of 4 entries. 


MODE = {370/370XA|ALL} 

PRINT = {AL|DR|PS|PT|SD|SU|NO} 
SHORT[= Y]|/=N 

SYMCDE = {nnnn|nnnX|nnXX|nX XX} 
SYSEXN|= Y]/=N 

SYSUM[= Y]|=N 

TABSIZE = nnnK 

TERMN = name 

THRESHOLD = (xxx,yyy) 


TIME = (hhmm{3}hhmm) 
Time range. 


TRENDS|= Y]|=N 
TYPE =[A)[B][C][D][E)IFUA}EIM OST Z) 


VOLID =(volser|,volser] ... ) 
Maximum of 4 entries. 


ZERO[= Y]|=N 


Figure 7-2. Syntax Summary for EREP Parameters 
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Chapter 8. EREP Control Statements 


You use EREP control statements in addition to EREP parameters to direct 
EREP processing. Control statements give EREP more information about your 
configuration and about how you want it to organize the report you are 
requesting. 


As a general rule, you have to provide several control statements for each EREP 
run. Often, the same control statements apply to several EREP runs — when you 
are producing a complete set of reports for the installation for a given day or 
week, for example. The control statements change only when your configuration 
changes. In addition, some of the EREP control statements require considerable 
preparation before they can be added to the EREP job. For all these reasons, 
most large installations create a separate data set containing the control state- 
ments for their EREP run, and name that data set rather than entering the indi- 
vidual control statements in the input data stream.! 


1 When EREP runs under a VSE system, all the EREP controls and system controls 
are read from the system input data set, SYSIPT, so a separate data set for control 
statements may not be feasible. 
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Control Statements and Reports 


Control Statements and Reports 2 


Some EREP control statements are fairly general-purpose, applying to most of the 
reports and most kinds of devices. Others are quite report-specific and product- 
specific. 


Figure 8-1 shows which control statements you can use with the various EREP 
report parameters. 









REPORT 
PARAMETERS 


CONTROLLER | DASDID ae ea 


EVENT OOC—tSC‘sC“‘(s 
PRINT=AL | SSSC—~—SC‘C~;C~rSCSSC‘r 









a — 
[sysexN——=«dtSSSC~C~C~“~sSCYS |S | VS 
sysum si SSCSC=~sSC~‘irSCSCS~*dSCS 
‘THRESHOLD || _ves—-|——=~id~S~*w Svs 
[TRENDS Si SSSSSCS~—SSC~iSSCS~*d CS _ 


Figure 8-1. EREP Control Statements for EREP Reports 







Notes: 


1. These PRINT options include Detail Summaries, which can include shared I/O 
devices. 


2. Tape only. 
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C 


General Coding Rules 


Coding Control Statements 


Each EREP control statement has its own coding rules, which are detailed under 
the individual control statement headings. There are a few general rules, however, 
that you must follow: 


Using ENDPARM. Control statements cannot be intermixed with EREP 
parameters. If parameters and control statements are in the same data set 
(separate or instream), you must code ENDPARM to indicate the end of 
parameters before coding any control statements. If you omit ENDPARM 
between parameters and control statements, EREP considers it a syntax error. 


Entering Control Statements: The EREP control statements must always be 
entered as SYSIN data (SYSIPT, for VSE systems). In the cases of VSE and 
MVS JCL, when there are not many control statements involved it may be 
easiest to do this by entering the control statements as instream data. For 
example, under VSE: 


// EXEC  IFCEREP1 

SYSUM, DATE=84254 

ENDPARM 
SHARE=(XA.0111111.032X,XA.0222222.03FX) 
SHARE=(XA.0111111.09A0,XA.0222222.09A6) 


Y fas 


When running EREP under MVS, the control statements need not be 
instream. Putting even a few control statements into a separate data set is 
almost always more accurate. See the SYSIN DD statement under “MVS 
System Controls” on page 4-32 for more information on how to do this. 


When running EREP under VM, you can specify all EREP controls as sepa- 
rate operands of the CPEREP command or put them in a separate data set 
named on the command. In either case, CPEREP sees them as instream 
input records. 


Continuing Control Statements: You cannot continue a control statement 
from one line to the next. However, with a few exceptions, you can code 
several control statements of the same type in order to convey your informa- 
tion to the EREP program. See the individual control statements for more 
details. 


Figure 8-7 on page 8-22 summarizes the EREP control statements’ syntax. More 
detailed coding considerations are in the following pages. 
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CONTROLLER Control Statement 
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The CONTROLLER statement indicates to EREP which CUAs or device 
addresses (that 1s, I/O units) are attached to a particular control unit. Using this 
information, EREP can combine the errors for that control unit in the report you 
are requesting. The CONTROLLER control statement is used primarily, if not 
only, for the Threshold Summary report. 


Indicates: 


Syntax: 


Default: 


Coding: 


The range of device addresses (CUAs) on a control unit, allowing you 
to total the error counts from one control unit. You can specify up 
to 32 CUAs for a single control unit. 


Each entry on the CONTROLLER statement defines a controller 
grouping; that is, the range of devices on a particular control unit. 
Additional entries on this and other CONTROLLER statements 
define other controller groupings. Every entry on a CONTROLLER 
statement must, therefore, define the complete set of devices attached 
to a particular control unit. 


CONTROLLER = (cpuser.{ccua|ccuX|ccua-ccua}[,cpuser.{ccua|ccuX|ccua-ccua}| . . . ) 
cpuser is a six-digit decimal CPU serial number (digits 0-9). 


ccua is a three- or four-digit hexadecimal channel-control unit- 
device address (digits 0-F). 


ccuX is a two- or three-digit hexadecimal channel-control unit 
number with X indicating all the device addresses (0-F) 
attached to that control unit. 


ccua-ccua 1s a range of continuous addresses. The low end of the 
range must be first. The range must be at least one, and 
cannot exceed 32. 


None. 


Unless you use CONTROLLER statements to request the totaling of 
errors by control unit, EREP presents the errors by individual device 
address. 


e “CONTROLLER” must be the first word in the statement, fol- 
lowed by an equal sign and the desired values in parentheses. No 
embedded blanks are allowed. 


@e Where the CONTROLLER statement specifies only part of the 
0-F range of device addresses, and physical devices are attached 
to addresses in the remaining portion of the range, you should 
use another CONTROLLER entry to define the remaining 
devices, thus preventing misleading output. 


J 


Notes: 


CONTROLLER Control Statement 


You cannot overlap device address ranges on two CON- 
TROLLER statements. That is, when you specify a range 
(cpuser.ccua-ccua) of addresses on a CONTROLLER statement, 
you must specify that range the same way each time you use it on 
any other CONTROLLER statement. 


If you specify a particular processor-device address combination 
on a CONTROLLER statement, you cannot specify a range that 
includes that particular combination on that or any other CON- 
TROLLER statement. 


Coding a range of device addresses (ccua-ccua): 


— If the control unit digit (u) in the low CUA is odd, the high 
CUA must have the same ccu digits. 


For example: 


0350-0357 is valid; 
0358-0367 is not valid. 


— If the control unit digit (u) in the low CUA is even, the high 
CUA must have the same even ccu digits, or the next-greater 
odd u digit. 


For example: 


0368-036F Is valid; 
0368-0377 is valid; 
0368-0388 is not valid. 


You can combine CONTROLLER statements with SHARE 
statements to make EREP combine the errors for shared devices 
by control unit. (See “SHARE Control Statement” on 

page 8-18.) 


The number of distinct CPUs (cpuser) specified on CON- 
TROLLER statements, or on SHARE and CONTROLLER 
statements combined, cannot exceed 16. (System Summary uses 
only the first nine.) 


The CPU entries that appear on CONTROLLER statements 
override the default letter assignments EREP makes for 
processors that appear in reports. See “How EREP Assigns 
Letters to CPUs” on page 2-92. 
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Example: The following example illustrates the use of the CONTROLLER 
statement to define a controller grouping containing the full range of 
32 devices: 


CONTROLLER=(011111.0480-049F) 
The result of this statement is that EREP combines the errors 


reported from the devices at addresses 0480 through 049F on CPU 
011111 in one report entry. 
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DASDID Control Statement 


You need DASDID control statements to identify certain DASD devices to EREP 
for the System Exception report series, so EREP can arrive at the correct prob- 
able failing unit (PFU). See Chapter 15, “Direct-Access Storage Devices 
(DASD)” for the devices involved. 


The DASDID statements provide physical identifiers for the DASD in your instal- 
lation that do not provide them directly. They also define the different paths 
from processors to devices, in much the same way as do SHARE statements. For 
this reason, the DASDID statements take the place of SHARE statements for the 
DASD Subsystem Exception reports; you can include the SHARE statements for 
DASD when you run the System Exception report series, but EREP ignores them 
and uses the DASDID information instead. 


The DASDID control statements reflect your hardware configuration, identifying 
the devices in your installation and the paths (channel-storage control unit- 
controller) between them and the processors they work with. 


In order to use DASDID statements, you will need to set them up before you 
request the System Exception report series. In order set up the statements, you 
must properly define the configuration of DASD in your installation. See 
“Setting up DASDID Controls” on page 8-9 for detailed directions on preparing 
DASDID controls. 


Indicates: The paths from a processor through channel, storage control unit and 
controller, to each drive; to identify the device for the DASD System 
Exception reports. 


Syntax: DASDID statements’ formats differ depending on whether the 
processor is running in 370 mode or 370-XA mode. 


The syntax of the 370-mode DASDID control statement is. 
DASDID CPU = annnan,CH = xx,SCU =ss,STR= ccuu,STR= ccuu,STR = ceuu,STR = ccuu 


nnnnnn is a six-digit decimal CPU serial number. 


xXx is a two-digit hexadecimal number identifying the channel 
(CH) between this CPU and the storage control unit. 


SS is the physical identifier of the storage control unit (SCU). 
For 3880s, the number is the physical ID set for the storage 
director; for 3830s, it is any hexadecimal number you assign, 
in the range of 02-FF. Each SCU must have a unique ID 
number. 
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Default: 


Coding: 


CCUuu 


is a four-digit hexadecimal! value representing the controller 
and unit address for each DASD string (STR). The DASD >) 
string is the set of eight unit addresses assigned to one con- 

troller (or pair of controllers): 


cc is the number you assign, in the range of 01-FE, to each 
controller. Each controller must have a unique ID 
number; however, controllers with string switch and 
3350s with alternate controllers should have only one ID 
number. 


uu is the last two digits from the lowest address on the 
string. The second digit should be 0 or 8. 


The format of the 370-XA mode DASDID control statement is: 
DASDID CPU = Xnannn,CHP = xx,SCU = ss,STR = ccddd,STR = ccddd,STR = ccddd,STR = ccddd 


Xnnnnn is a five-digit decimal CPU serial number preceded by an X 


XX 


SS 


ccddd 


None. 


in the central processor (CP) identifier position. 


is the two-digit hexadecimal number identifying the channel 
path identifier (CHP) between this CPU and the storage 
control unit. 


is the physical identifier of the storage control unit (SCU). 

For 3880s, the number is the physical ID set for the storage | 
director; for 3830s, it is any hexadecimal number you J 
assign, in the range of 02-FF. Each SCU must have a 

unique ID number. 


is a five-digit hexadecimal value representing the controller 
device number for each DASD string (STR). The DASD 
string is the set of eight device numbers assigned to one 
controller (or pair of controllers): 


cc is the number you assign, in the range of 01-FE, to 
each controller. Each controller must have a unique 
ID number; however, controllers with string switch, 
and 3350s with alternate controllers, should have only 
one ID number. 


ddd is the lowest device number on the string. 


If you omit DASDID statements, those DASD that do not provide 
their own physical IDs are identified on the reports only by device 


type. 


“DASDID” must be the first word in the statement, followed by one 
blank and the CPU = keyword with its associated value. The 
keywords on this statement are positional, and must be separated by J 


commas. 


DASDID Control Statement 


Examples: You will probably never need just one DASDID statement. See the 
detailed description of setting up DASDID controls on the following 
pages for examples of DASDID statements. 


Setting up DASDID Controls 


You will find comment statements useful to describe a group of DASDID state- 
ments, documenting the statements for future updates. The TOURIST data set 
output for the System Exception report series includes the DASDID statements 
used and a table showing the generated configuration. This must agree with your 
actual configuration if the probable failing unit assignments in the System Excep- 
tion reports are to be accurate. 


Figure 8-2 on page 8-10 shows one way to graphically define the DASD config- 
uration in an installation. Note that it is an example, not a model configuration. 
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CPU 022222 CPU 033333 


CPU X11111 


CHPIDS: 





CHANNELS: (AP or MP) 


3880 3830 
SD-2 
PHYSICAL ID=15 ID=EE 


3350 3333 
ID=02 ID=14 





3880 


SD-1 
PHYSICAL ID=14 








5350-11 


3350 3330-11 3330-1 


3350 Bt 3330-11 3330-11 3330-1 


ADDRESSES (DNO): ADDRESSES (DNO): 
CPU X11111 CPU X11111 
3350 Reul 3330-11 988-98D 990-995 
A88-A8D A90-A95 
CPU 022222/033333 CPU 022222/033333 
808-80D 810-815 
ADDRESSES (DNO): ADDRESSES (DNO): A08-AOD A10-A15 
CPU X11111 CPU X11111 
778-77F 980-987 
ABO-A87 
CPU 022222/033333 
B00-807 
AOO-AO7 
Notes: 


1. The PHYSICAL IDs for the 3880s (14 and 15) are those switched into the storage director. 
2. The IDs for the 3830, the 3350, and the 3333s are arbitrary unique numbers that you assign. 


Figure 8-2. DASD Configuration Diagram for DASDID Statements 
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( Preparing to Code DASDID Controls 
You do not need DASDID statements for DASD that provide their own physical IDs 
(for example, 3375s and 3380s). If you choose to code control statements for 


these devices, make sure the physical IDs you create match those switched into 
the storage director(s). 


To set up DASDID controls for your DASD subsystem, you may follow three 
basic steps: 


1. Set up a diagram of your actual DASD configuration, if you do not already 
have one. 


a. Show all connections between DASD controllers, storage control units, 
and channels or channel paths, as is done in Figure 8-2. 


b. Include any attached processors or multiprocessors that can record data 
on the ERDS. See CPU 033333 in Figure 8-2. 


c. Label each channel or channel path, as shown. 
d. Label the devices that have physical IDs. 
e. Create physical [Ds for the devices that do not provide their own: 


1) Assign a unique ID to each 3830. Do not duplicate IDs used on 
other storage control units. 


2) Assign a unique ID to each controller that does not have one. Do 
not duplicate IDs used on other controllers. 


3) Determine the lowest unit address (or device number; the last two 
digits of the device address) for each string, by processor (CPU). 


f. Assign a unique label to each processor in the diagram. 
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2. Create a comment line (asterisk in the first column) for each storage control 
unit, indicating the controllers connected to it and the DASD strings con- 
nected to the controllers. For example: 


*SCU15 CTRL14,33,22 CPU A (980-995) B (800-815) 


describes one of the storage control units shown in Figure 8-2. This is 
storage control unit 15, which is connected to strings 980-987, 988-98D, and 
990-995 from CPU A (X11111); and to strings 800-807, 808-80D, and 810-815 
from CPU B (022222). The paths to the devices are through controllers 14, 
33, and 22, in that order. 


a. The comment lines serve two purposes: 
1) They outline the DASDID statements. 


2) They document the DASDID statements in case of future configura- 
tion changes. 


b. The STR value in the DASDID statement consists of the controller ID 
and the lowest address or device number from the string attached through 
that controller to the CPU. 


3. Create DASDID statements according to the comment lines. 


Figure 8-3 shows the completed comments and DASDID statements for the 
configuration shown in Figure 8-2. 


KREKKKEKEKEKEKKKKEKKEKEKEEKEKKKEKEKEKKEKKEKEKEKRKKEKEKKKEKKEEKEEKKKKKKRKRKKEKEKKEKKKKKRKRKKKKKRKEK 


Kk KKK KKK KKEKEKEKEXTNPUT FOR DASD CONFIGURATION CHARTRR KERR RKKKKKKE KK KKK 
KKK KKK KKK KEKEKEEERKDISK DATASET SYSEXN. CONTROLSE REE R KKK KKK KKK KK RR KR KK 
HR KKK IK IR IK IK KOK TOK IKK IK RIOR IR KR KK TOR RR IR TK TOR IO IR RII RR RR RR RR KR 
SYSEXN , TABSIZE=512K,HIST, DATE=84348 , ACC=N 

ENDPARM 

RRR KK KKK IK IK KKK KR IK IK IKI KK I KKK KIKI KR IK IK IKI KKK KK KIKI KKK ERR ERK KKK KK IK 


* CPU DEFINITIONS A=X11111 B=022222 and 033333 


* SCU 14 CTRL 02 A(778-77F) 
DASDID CPU=X11111,CHP=07 ,SCU=14,STR=02778 
 SCU. 5 CTRL 14,33,22 A(980-995) B(800-815) 


DASDID CPU=X11111,CHP=09,SCU=15,STR=14980 , STR=33988,STR=22990 
DASDID CPU=022222 ,CH=08,SCU=15,STR=1400 , STR=3308,STR=2210 
DASDID CPU=033333,CH=08,SCU=15,STR=1400,STR=3308 , STR=2210 

* SCU EE CTRL 14,33,22 A(A80-A95) B(AOO-A15) 

DASDID CPU=X11111,CHP=0A,SCU=EE,STR=14A80 , STR=33A88 , STR=22A90 
DASDID CPU=022222,CH=0A,SCU=EE,STR=1400, STR=3308,STR=2210 
DASDID CPU=033333,CH=0A,SCU=EE,STR=1400 ,STR=3308,STR=2210 


KRKEKKEKEKEEKEKKKK KK KEKE KKKEEKEKE KEKE KKKKKRERKEKKKKKKE KKK KK KKK KKK KKK KEK 


Figure 8-3. Examples of DASDID Control Statements 
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( Checking Your DASDID Statements 


To check the accuracy of your DASDID statements, you can do the following: 


I. 


Run EREP, requesting the System Exception reports. Use the following JCL 
(or its VSE or VM equivalent): 


//SYSEXN EXEC PGM=IFCEREP1,REGION=1000K,PARM='CARD' 


/ /ACCIN DD DUMMY , DCB= (RECFM=VB , BLKSIZE=3200) 
//TOURIST DD SYSOUT=A , DCB=BLKSIZE=133 

//EREPPT DD DUMMY , DCB=BLKSIZE=133 

//DIRECTWK DD DUMMY 

//SYSIN DD DSN=SYSEXN. CONTROLS , DCB=(RECFM=FB, 
// BLKSIZE=3200,LRECL=80) , DISP=SHR 
f* 


The SYSIN data set consists of the EREP parameters needed to run the 
System Exception reports, and the comment lines and DASDID control state- 
ments developed earlier. Figure 8-3 on page 8-12 includes the contents of the 
SYSIN data set for the DASD configuration in Figure 8-2. 


When the TOURIST data set (informational messages) output appears, check 
the configuration chart against your comment lines to be sure that your 
DASDID statements reflect your actual configuration. Figure 8-4 on 

page 8-14 shows the configuration chart produced for the DASDID state- 
ments in Figure 8-2. 
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The DASDID Configuration Chart 


The DASDID configuration chart can only handle the more common DASD con- 
figurations. In addition to the information shown in Figure 8-4, there might be 
one or more notes following the chart itself. Figure 8-5 shows the possible notes 
and their meanings. 


LEVEL = VERSION 3 RELEASE 1 FEATURE LEVEL = 84251 
INPUT PARAMETER STRING HIST ,ACC=N ,SYSEXN 


* CPU DEFINITIONS A=X11111 B=022222 C=033333 

* SCU 14 CTRL 02 A(778-77F) 

DASDID CPU=X11111,CHP=07,SCU=14,STR=02778 

* SCU 15 CTRL 14,33,22 A(980-995) B(800-815) 

DASDID CPU=X11111,CHP=09,SCU=15,STR=14980 , STR=33988 , STR=22990 
DASDID CPU=022222,CH=08,SCU=15,STR=1400 ,STR=3308,STR=2210 
DASDID CPU=033333,CH=08,SCU=15,STR=1400 ,STR=3308 ,STR=2210 

* SCU EE CTRL 14,33,22 A(A80-A95) B(AOO-A15) 

DASDID CPU=X11111,CHP=0A,SCU=EE,STR=14A80, STR=33A88 , STR=22A90 
DASDID CPU=022222 ,CH=0A,SCU=15,STR=1400 ,STR=3308,STR=2210 
DASDID CPU=033333,CH=0A,SCU=15,STR=1400,STR=3308,STR=2210 


DASDID CONFIGURATION CHART 

CPU(S) - CPUS WITH IDENTICAL CONFIGURATIONS ARE IN THE SAME COLUMN 

SCU - STORAGE CONTROL UNIT ID 

CC,CC,CC,CC - CONTROLLER IDS ORDERED BY PHYSICAL UNIT ADDRESS 

CHAN - CHANNELS WHICH CONNECT TO THE STORAGE CONTROL UNIT 

UA-UA - LOWEST PHYSICAL UNIT ADDRESS OF FIRST AND LAST STRING (370 MODE) 
DNO-DNO - LOWEST DEVICE NUMBER OF FIRST AND LAST STRING (370-XA MODE) 


CPU(S) CPU(S) 
X11111 022222 
033333 
SCU Ce CECE ACC CHAN DNO-DNO CHAN UA-UA 
14 02 O07 778 
15 14,33,22 09 980-990 08 00-10 
EE 14,33,22 OA A80-A90 OA OO0O-10 


PARAMETER OPTIONS VALID FOR THIS EXECUTION 


RECORD TYPES (MCH,CCH,OBR,SOFT,IPL,DDR,MIH,EOD,MDR,MODE ALL), 
SYSTEM EXCEPTION ,HISTORY 

DATE/TIME RANGE - ALL 

TABLE SIZE - 512K,LINE COUNT - 050 


NONE 

IFC221I NO SHARE CARD 

IFC1201 3 RECORDS SAVED FOR SYSEXN 
IFC1201 3 RECORDS THAT PASSED FILTERING 


Figure 8-4. TOURIST Output: DASDID Configuration Chart 
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C nae. cele) COULD NOT BE FORMATTED. CC, CHANNEL, AND UA/DNO ARE GIVEN BY CPU. 

THE SCU(S) INDICATED ABOVE COULD NOT BE FORMATTED FOR THE FOLLOWING REASON(S). 
1. THE NUMBER OF CONTROLLER IDS DOES NOT EQUAL THE NUMBER OF UA/DNOS FOR A CPU. 
2. THE CONTROLLER IDS ARE NOT THE SAME FOR ALL THE CPUS ATTACHED TO THE SCU. 
3. THE UA/DNOS FOR A CPU ARE EXPECTED TO CONSECUTIVELY INCREASE BY EIGHT. 

THIS MAY NOT NECESSARILY BE AN ERROR. 

4. THERE ARE MORE THAN FOUR UA/DNOS FOR A CPU. 
5. THERE ARE MORE THAN THREE CHANNELS FOR A CPU IN 370 MODE. 
6. THERE ARE MORE THAN FOUR CHANNELS FOR A CPU IN 370-XA MODE. 
7. THERE ARE MORE THAN FOUR CONTROLLER IDS FOR AN SCU. 


Figure 8-5. Notes Accompanying the DASDID Configuration Chart 


EXPLANATION: 


I. The program generating the configuration table found that there was not a con- 
troller ID for each set of addresses or device numbers. Because the controller 
ID defines a string of devices, there must be a unique controller ID for each 
string defined by its lowest unit address/device number. The controller ID is the 
first two digits of the STR parameter. 


2. There should be only one SCU or controller assigned to a specific ID for the 
installation. The controller ID must be the same for a string no matter which 
CPU it is accessed from. Check the STR parameters to determine which 
string (s) have different controller IDs defined for the same string. 


3. In order to format the unit addresses (UAs) or device numbers (DNOs) as a 
range (for example, 120-12F), the numbers must be consecutive. The numbers 
in the group were not increasing consecutively by eight; that is, the low-order 
digits of the UA/DNOs were more than eight apart. 


4. A maximum of four strings can connect to one SCU (unless a switch is used). 
At least one CPU was found to have more than four strings defined by con- 


troller ID or unit address/device number. 


5. The configuration generator provides space in the format for only three channels 
from one CPU to an SCU, in 370 mode. 


6. The configuration generator provides space in the format for only four channel 
paths from one CPU complex to an SCU, in 370-XA mode. 


7. Four is the maximum number of strings allowed per SCU. 
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LIMIT Control Statement 
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The LIMIT control statement allows you to set error thresholds, or limits, for 
EREP to use for the Subsystem Exception reports. The keyword values you 
specify on LIMIT statements control the printing of temporary and soft (non- 
terminating) errors: the reports include data only for devices with errors that 
equal or exceed any of the limits you specify. 


You can cut down on the number of records EREP uses for the System Exception 
reports, and, thus, on the amount of printed report output, using the LIMIT 
statement. 


Also, the only way to see temporary error data in the Subsystem Exception reports 
for your supported tape subsystems is to set up LIMIT statements. (The tape Tem- 
porary Error Summary shows all temporary errors regardless of LIMIT state- 
ments.) 


Indicates: The limits EREP is to apply to temporary/soft errors produced by the 
indicated device type or processor model, for the System Exception 


reports. 
Syntax: LIMIT {dasd,dkeyword|,dkeyword] . . . |tape,tkeyword|,tkeyword] . . . |cpu,ckeyword|,ckeyword] . . . 
dasd represents the generic device type designation for DASD 
products. 
tape represents the generic device type designation for tape pro- 
ducts. 
cpu represents the generic machine type designation for 


processor products. 


dkeyword represents one or more product-dependent keyword 
parameters with associated numeric limits. 


tkeyword represents one or more product-dependent keyword 
parameters with associated numeric limits. 


ckeyword represents one or more product-dependent keyword 
parameters with associated numeric limits. 


Because the possible device types, keywords and numeric expressions 
are product-specific, their descriptions are in Part 4, “Product- 
Dependent Information”; see the sections for DASD, magnetic tape 
and processors for details. 











Default: 


Coding: 


Example: 


LIMIT Control Statement 


The default action for the LIMIT statement varies according to the 
product involved. See the discussions of the LIMIT statement in 
Part 4, “Product-Dependent Information.” 


See the discussion of the LIMIT statement in the DASD section of 
Part 4, “Product-Dependent Information” for ways to force EREP 
to include all temporary error records in the System Exception 
reports. 


The LIMIT statement is different for each of the product groups to 
which it applies, so you must code it differently for each. The details 
are in Part 4, “Product-Dependent Information.” There are a few 
general rules that apply, as well: 


e “LIMIT” must be the first word in the statement, followed by 
one blank, the device or machine type, and the keyword parame- 
ters, separated by commas. 


e If you code more than one LIMIT statement for a device type, 
EREP uses the temporary error limits set in the latest LIMIT 
statement; the values on a second statement override those on a 
previous one. 


See the DASD, tape, and processor sections of Part 4, “Product- 
Dependent Information” for the details of coding and using LIMIT 
statements, including examples. 


Exceptions: The LIMIT statement is not valid for these devices: 


9332 
9335 
9347 
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SHARE Control Statement J 
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The SHARE control statement directs EREP to combine errors for a single device 
that is shared between processors or systems. The report you request then associ- 
ates all the errors for that device with the device address or number you have 
specified, rather than with the different processors. 


You can use SHARE statements for all the EREP reports except the Event 
History. When you include SHARE statements in your EREP controls, each 
report indicates whether a particular set of error data represents a device that you 
specified on SHARE statements. 


You can also use SHARE statements to influence the way EREP assigns alpha- 
betic identifiers to the processors that appear on its reports. This is described in 
“How EREP Assigns Letters to CPUs” on page 2-92. 


Indicates: The possible paths to a device being shared between processors. 
Syntax: SHARE = ([XA. ]cpuser.{ccua|ccuX|ccua-ccua}|,[XA.]cpuser.{ccua\ccuX|ccua-ccua}] . . . ) 


[XA.]cpuser is a six-digit decimal CPU serial number (digits 0-9). As 
cpuser, it indicates the processor is running in 370 mode; 
as XA.cpuser, it indicates the processor is running in 
370-XA mode. 


ccua is a three- or four-digit hexadecimal channel-control 2S) 
unit-device address or device number (digits 0-F). The 3 
first digit is the channel designated to the operating 
system as “primary”; hence, this is the primary CUA for 
the device. 


ccuX is a two- or three-digit hexadecimal channel-control unit 
address. The X implies device addresses 0 through F. 


ccua-ccua 1s a range of continuous addresses. The low end of the 
range must be first. The range must be at least one, and 
cannot exceed 32. 


Default: None. 


If you omit this control statement, EREP presents each device’s error 
records individually by device type in its reports. 


Coding: 


e “SHARE” must be the first word on the statement, followed by 
the equal sign and the desired values in parentheses. You must 
put at least two entries (cpuser.ccua|ccuX|ccua-ccua) on each 
Statement. 


Examples: 


SHARE Control Statement 


The number of distinct CPUs specified (cpuser) on SHARE state- 
ments cannot exceed 16. (System Summary uses only the first 10; 
see “System Summary Part 1” on page 2-2.) 


Should you use both SHARE and CONTROLLER statements, 
to make EREP group errors for shared devices by both device 
and control unit, the total number of CPUs on SHARE and 
CONTROLLER statements combined cannot exceed 16. 


You might need more than one SHARE statement to show all 
the possible paths to one device. If so, you should repeat the first 
entry on the statements for the remaining paths, because EREP 
equates all the paths on the SHARE statement to the one you 
specify first. For example: 


SHARE=(011111.01F0,022222.0330,022222.06F0,022222.0FFO) 
SHARE=(011111.01F0,033333.03F0,033333.0630,033333.0F30) 


The “cpuser” values on SHARE statements override EREP’s 
default CPU letter assignment, which is in ascending alphabetical 
order starting with the first model/serial number encountered. 
See “How EREP Assigns Letters to CPUs” on page 2-92. 


Once you have specified a range (cpuser.ccua-ccua) on a SHARE 
statement, you must specify that range the same way each time 
you use it on any other SHARE statement. This prevents the 
overlapping of ranges. 


See the following section for more detailed information, including 
examples. 
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SHARE Control Statement 


Using SHARE Statements to Combine Data in EREP Reports 


Addresses from 
CPU 011111: 
Primary = 01BO - O1BF 


Alternate = O3B0 - O3BF 






2 Strings of 
3350s: BO-B7 
and B&8-BF 


Addresses from 

CPU 022222: 

Primary = O2B0O - O2BF 
Alternate = 03B0 - O3BF 


Figure 8-6 is an example of the kind of I/O configuration that could require 
SHARE statements. The text on the next page explains how you would set up 
SHARE controls for the illustrated configuration. 














Addresses from 
CPU 011111: 
Primary = 0460 - 0467 
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7 2 . Addresses from 
i CPU 022222: 
Os aaa Primary = 0560 - 0567 


Alternate = 0760 - 0767 


Figure 8-6. Configuration for SHARE Statements 
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Alternate = 0660 - 0667 





SHARE Control Statement 


( SHARE Statements for DASD Drives 


To cause EREP to combine all records for the DASD drives in the strings, use: 


SHARE=(011111.01BX,022222 .02BX) 


OR 


SHARE=(011111.01B0-01BF ,022222.02B0-O02BF) 


Either of these SHARE statements causes the records from DASD drive 0 (device 
addresses/numbers 01B0 and 02B0) to be combined and presented as data for 
01B0 on CPU 011111. 


Without the SHARE statements, the records would be presented by the primary 
channel address for each processor. That is, records for drive 0 on CPU 011111 
would be presented as 01B0, regardless of whether they were recorded on channel 
01 or 03; and records for drive 0 on CPU 022222 would be presented as 02B0, 
regardless of whether they were recorded on channel 02 or 03. 


SHARE Statements for Tape Drives 


To cause EREP to combine all records for the tape drives in the strings, use: 


SHARE=(011111.0460-0467 ,022222.0560-0567) 


This SHARE statement causes all records from drive 7 (device address/numbers 
0467 and 0567) to be combined and presented as data for 0467 on CPU 011111. 


Without the SHARE statements, the records would be presented by the primary 
channel address for each processor. That is, records for drive 5 on CPU 011111 
would be presented as 0465, regardless of whether they were recorded on channel 
04 or 06; and records for drive 5 on CPU 022222 would be presented as 0565, 
regardless of whether they were recorded on channel 05 or 07. 
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Control Statement Syntax 


Syntax Summary for EREP Control Statements 


CONTROLLER = (cpuser.{ccua| 
ccuX|ccua-ccua}|,cpuser.{ccua|ccuX|ccua-ccua}] ... ) 


The syntax of the 370-mode DASDID control statement is: 
DASDID CPU = nnnnnn,CH = xx,SCU =ss,STR = ccuu,STR = ccuu,STR = ccuu,STR = ccuu 


The syntax of the 370-XA mode DASDID control statement is: 
DASDID CPU = Xannnn,CHP = xx,SCU = s5,STR = ccddd,STR = ccddd,STR = ccddd,STR = ccddd 


LIMIT {dasd,dkeyword|,dkeyword] .. . \tape,tkeyword|,tkeyword] . . . |cpu,ckeyword|,ckeyword] .. . 


SHARE = ([XA.]cpuser.{ccua|ccuX|ccua-ccua}|,[XA.]cpuser.{ccua|ccuX|ccua-ccua}] ... ) 


Figure 8-7. Syntax Summary for EREP Control Statements 
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Chapter 9. CPEREP Operands - Syntax and Coding 


To run EREP under a VM system, you use the CMS command, CPEREP. 
CPEREP has the following syntax: 


CPEREP [filename filetype {filemode|*}] 


You must have the proper user privilege class to run CPEREP. See the note 
under “Entering CPEREP Operands” on page 9-8 for more information. 


You control EREP under VM using the same parameters and control statements 
that you use for running EREP under MVS or VSE; however, those controls 
become operands for the CPEREP command. 


Using the CPEREP Command 


c You have several options for entering and executing the CPEREP command: 


l. 


Enter CPEREP by itself, and allow the system to prompt you for the indi- 
vidual operands you want to specify. An example of this method is in 
“Prompting Method” on page 9-10. 


Create a file, using the system editor, that contains the operands for this exe- 
cution of CPEREP. Include the name, type and mode of the file on the 
CPEREP command, as shown in the syntax. This method is used in the VM 
master examples in Chapter 4, under “Running EREP under VM.” 


Within a CMS EXEC, use &STACK control statements to enter the operands 
as instream data before the EXEC statement. An example of this is in 
“Stacked Entry Method” on page 9-13. 


Combine the above methods in various ways. This option is discussed in 
more detail in “Mixed Entry Method” on page 9-14. 


See the User’s Guide for your version of CMS for more information on coding 
CMS EXECs and executing CMS commands. 
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CLEAR/CLEARF and TERMINAL 


Unique CPEREP Operands 2 


In addition to the regular EREP parameters and control statements, you need two 
other operands for running EREP via CPEREP. These are the CLEARF 
operand and the TERMINAL operand, both of which act as processing controls. 


CLEAR/CLEARF operand 
Clears (zeroes) and reinitializes the error-recording area (ERDS). 


Note: You must have the proper user privilege class to erase and reinitialize 
the error-recording area. In most VM installations, this is privilege 
class F. 


If there are SRF frame records on the ERDS for 303X processors, you use 
CLEARF to rewrite the frames on the data set. CLEAR/CLEARF is never 
combined with other EREP controls; you are reinitializing the ERDS. See 
“Information about the VM SCP” on page 24-8 and the discussion of the 
303X processors in Chapter 20, “Processors (CPUs)” for more about the 
ERDS and frame records. 


TERMINAL operand 
Instructs CPEREP to stop reading EREP parameters and control statements 
from a separate file and to prompt the user for them instead. You use this 
CPEREP operand to change your EREP controls dynamically. Having set 
up an input file containing CPEREP operands, you have the choice of using 
those operands or overriding them with others entered from the terminal. 2 
See “Mixed Entry Method” on page 9-14 for more information. mas 
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C 


C 


Operand Summary 


Using EREP Controls as CPEREP Operands 


The same rules and restrictions apply to EREP controls regardless of the system 
they are being used for. However, when you enter them as CPEREP operands 
you must also follow the rules imposed by the VM facility. “Entering CPEREP 
Operands” on page 9-8 lists those rules along with several possible ways to 
present the operands to CPEREP. The table on the next few pages lists all the 
EREP controls/operands in aphabetical order and indicates where you can find 
more detailed information on each one. See Figure 9-2 on page 9-7 fora 
summary of the operands’ syntax. Examples of their use are in “Entering 
CPEREP Operands” on page 9-8. 


CPEREP 
OPERAND 


TYPE OF 
EREP CONTROL 


An EREP processing parameter. 


CLEAR/CLEARF | An operand unique to CPEREP. 

CONTROLLER An EREP control statement — 
combining errors from devices 
associated with a single con- 
troller. 


CPU An EREFP selection parameter — 
selecting records by processor 
model and serial number. 

CPUCUA An EREFP selection parameter — 

selecting records by processor 


serial number and device 
address. 


P 
CUA An EREP selection parameter — 
selecting records by device 
address. 


DASDID An EREP control statement — 
identifying DASD units that do 
not provide their own physical 
IDs. 





NOTES AND 
REFERENCE 


When you use this operand, you must also 
make sure the ACCDEV file has been 
defined. See “ACC” on page 7-5 and 
“Defining Files for CPEREP” on page 4-49 
for more information. 


Use this operand, by itself, to clear and reini- 
tialize the error-recording area. See “VM 
System Controls” on page 4-49. 


See “CONTROLLER Control Statement” on 
page 8-4 for more information. 


See “CPU” on page 7-6 for more informa- 
tion. 


See “CPUCUA” on page 7-7 for more infor- 
mation. 


See “CUA” on page 7-8 for more informa- 
tion. 


This operand is for the System Exception 
report series. You will need to set up your 
DASDID controls before running CPEREP, 
and will probably want to put these and other 
control statements into a separate data set. 
See “DASDID Control Statement” on 

page 8-7 and “Entering CPEREP Operands” 
on page 9-8 for more information. 


DATE An EREP selection parameter— | See “DATE” on page 7-10 for more informa- 
selecting records by date. tion. 


Figure 9-1 (Part 1 of 4). EREP Controls as CPEREP Operands 
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Operand Summary 


CPEREP 
OPERAND 


DEVSER 


ENDPARM 


ERRORID 


HIST 
LIA/LIBADR 


LIMIT 
LINECT 


MERGE 


Figure 9-1 (Part 2 of 4). 


TYPE OF 
EREP CONTROL 


An EREP selection parameter — 
selecting (or excluding) records 
by device type. 


An EREP selection parameter — 
selecting records by the tape 
device serial number. 


The delimiter required between 
EREP parameters and control 
statements. 


An EREP selection parameter — 
selecting MCH and SFT records 
by software error ID. 


An EREP report parameter — 
requesting an Event History 
report. 


An EREP processing parameter 
— indicating that input records 
for EREP reports are in a 
history file rather than on the 
ERDS. 


An EREP selection parameter — 
selecting records by line interface 
base address. 


An EREP control statement — 
setting threshold values for the 
System Exception report series. 


An EREP processing parameter 
— indicating the number of lines 
to be printed on a page of 
output. 


An EREP processing parameter 
— indicating that input records 
for reports are to be taken from 
both the ERDS and a history 
file. 
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NOTES AND 
REFERENCE 


See “DEV” on page 7-11 for more informa- 
tion. 


This operand is used for the Threshold 
Summary report. See “DEVSER” on 
page 7-13 for more information. 


If you are entering both parameters and 
control statements, the parameters must 
precede ENDPARM and the control state- 
ments must follow it. See “Coding Control 
Statements” on page 8-3 and the examples on 
the following pages for more information. 


This operand applies to records created by an 
MVS guest system. See “ERRORID” on 
page 7-15 for more information. 


See “EVENT” on page 7-17 and “Event 
History Report” on page 2-12 for more infor- 
mation. 


When you use this operand, you must also 
make sure the ACCIN and DIRECTWK files 
have been defined. See “HIST” on page 7-18 
and “Defining Files for CPEREP” on 

page 4-49 for more information. 


This operand applies to records associated 
with 3705 and 3725 communications control- 
lers. See “LIA/LIBADR” on page 7-19 for 
more information. 


The syntax of this control statement varies 
widely from one product (processor/channel, 
DASD, tape) to another. See “LIMIT 
Control Statement” on page 8-16 and the 
appropriate sections in Part 4 for more infor- 
mation. 


The default value when running EREP under 
VM 1s 50. See “LINECT” on page 7-20 for 
more information. 


When you use the MERGE operand, you 
must also make sure the ACCIN, 
DIRECTWK and SERLOG files have been 
defined. See “MERGE” on page 7-21 and 
“Defining Files for CPEREP” on page 4-49 
for more information. 





EREP Controls as CPEREP Operands 


Operand Summary 


CPEREP TYPE OF NOTES AND 
OPERAND EREP CONTROL REFERENCE 


An EREP selection parameter — | See “MOD” on page 7-22 for more informa- 
selecting records by processor tion. 
model number. 


PRINT An EREP report parameter — Use PRINT =NO to prevent CPEREP from 
requesting one or more Detail producing any report output. See “PRINT” 
reports of specific records and/or | on page 7-24 and “Detail Edit and Summary 
specific devices. (PRINT) Reports” on page 2-62 for more 


information. 


SHARE An EREP control statement — You will probably want to put SHARE and 
combining errors associated with | other control statements into a single data 
shared devices. set. See “SHARE Control Statement” on 

page 8-18 and the examples on the following 
pages for more information. 


SHORT An EREP processing parameter Use this operand to suppress the printing of 
— indicating whether short OBR | short OBR records in Detail Edit reports. 
records are to be printed. See “SHORT” on page 7-26 for more infor- 


mation. 


SYMCDE An EREP selection parameter — | See “SYMCDE” on page 7-27 for more 
selecting 33XX DASD records information. 
by fault symptom code. 


SYSEXN An EREP report parameter — This operand produces a group of reports 
requesting the System Exception about major processing and I/O subsystems. 
report series. See “SYSEXN” on page 7-28 and “System 

Exception Reports” on page 2-20 for more 
information. 


SYSUM An EREP report parameter — See “SYSUM” on page 7-29 and “System 
requesting a System Summary. Summary” on page 2-2 for more information. 


TABSIZE An EREP processing parameter A TABSIZE value substantially larger than 
— indicating the amount of 24K could require a corresponding increase in 
storage to be used for EREP’s the storage size of the virtual machine that 
sort tables. CPEREP runs in. See “TABSIZE” on 

page 7-30 and the sections on storage 
requirements in Chapter 4 for more informa- 
tion. 

TERMINAL An operand unique to CPEREP See “VM System Controls” on page 4-49 and 
processing — requesting that the the discussion on the following pages for 
operator be prompted for more information. 

CPEREP operands. 


TERMN An EREP selection parameter — _ | This operand applies only to TP OBR records 
selecting records by terminal for Event History and Detail PRINT reports. 
name. See “TERMN” on page 7-31 and 

Chapter 22, “Teleprocessing (TP) Devices” 
for more information. 


Figure 9-1 (Part 3 of 4). EREP Controls as CPEREP Operands 
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Operand Summary 


CPEREP TYPE OF 
OPERAND EREP CONTROL 


THRESHOLD An EREP report parameter — 
requesting a Threshold Summary 
for some tape devices. 


TIME An EREP selection parameter — 
selecting records by time. 


TRENDS An EREP report parameter — 
requesting a Trends report. 

TYPE An EREP selection parameter — 
selecting records by record type. 


VOLID An EREP selection parameter — 


selecting records by volume ID 
(volume serial number). 


ZERO An EREP processing parameter 
— indicating whether the records 
on the ERDS (error-recording 
area) are to be erased when 
CPEREP has completed a 
report. 


NOTES AND 
REFERENCE 


A dual-purpose operand; you request the 
report and set the error-frequency thresholds 
at the same time. See “THRESHOLD” on 
page 7-32 and “Threshold Summary Report” 
on page 2-58 for more information. 


See “TIME” on page 7-34 for more informa- 
tion. 


See “TRENDS” on page 7-35 and “Trends 
Report” on page 2-7 for more information. 


See “TYPE” on page 7-36 for more informa- 
tion. 


This operand applies to 33XX DASD and 
34XX tape records only. See “VOLID” on 
page 7-38 for more information. 


This operand must be used carefully. See 
“ZERO” on page 7-39 for more information. 





Figure 9-1 (Part 4 of 4). EREP Controls as CPEREP Operands 
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Entering CPEREP Operands 


ACC[=Y]|=N 


Cc CLEAR|CLEARF 


Unique to CPEREP; see “VM System Controls” on page 4-49. 
CONTROLLER = (cpuser.{ccua|ccuX|ccua-ccua}|,cpuser.{ccua|ccuX|ccua-ccua}] ... ) 
CPU =(serial.modell,serial.modell ... ) 

CPUCUA =(serial.addr|,serial.addr| ... ) 
CUA=(entry[,entry] ... ) 


DASDID CPU = nnannn,CH = xx,SCU =ss,STR = ccuu,STR = ccuu,STR = ccuu,STR = ccuu 
370 mode: 


DASDID CPU = Xnnnnn,CHP = xx,SCU = 5s,STR = ccddd,STR = ccddd,STR = ccddd,STR = ccddd 
370-XA mode: 


DATE = (yyddd|{;}yyddd)) 
DEV =(type|,type] . . - ) 
DEVSER =(serial|,serial] ... ) 
ERRORID = (segno|,cpuid,asid,hh,mm,ss,t]) 
EVENT|= Y]|=N 
HIST[= Y]/=N 
LIA|LIBADR = address 
LIMIT {dasd,dkeyword|,dkeyword] . . . |tape,tkeyword|,tkeyword] . . . |cpu,ckeyword|,ckeyword] .. . 
LINECT = nnn 
MERGE = Y]| =N 
nd MOD = (modell,model] .. . ) 
MODE = {370/370XA|ALL} 
PRINT = {AL|DR|PS|PT|SD|SU|NO} 
SHARE = ([XA.]cpuser.{ccua|ccuX|ccua-ccua}|,[XA.]cpuser.{ccua|ccuX|\ccua-ccua}] ... ) 
SHORT[= Y]|=N 
SYMCDE = {nnnn|nnnX|nnXX|nXXX} 
SYSEXN[= Y]| =N 
SYSUM[= Y]|=N 
TABSIZE = nnnK 


TERMINAL = [= Y]|=N 
Unique to CPEREP; see “VM System Controls” on page 4-49. 


TERMN =name 

THRESHOLD = (xxx,yyy) 

TIME = (hhmm{;}hhmm) 

TRENDS|= Y]| =N 

TYPE =[A][B][C}[D][E] FANT EMJ[O}[STIXIY IZ] 
VOLID = (volser|.volser] . . . +) 

ZERO[= Y]| =N 


( Figure 9-2. Syntax of the CPEREP Operands 
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Entering CPEREP Operands 


Entering CPEREP Operands 


9-8 EREP User’s Guide 


In order to use the CPEREP command, you must be in the CMS environment 
and have a user privilege class that allows access to the records in the error- 
recording area. 


Note: With the latest releases of VM, it is possible for an installation to redefine 
the privilege classes in effect for its systems, overriding those set by IBM. 
Make sure you have the proper privilege class for this operation, whether it 
is C, E, F, or some other class. 


Figure 9-2 on page 9-7 shows the syntax of all the EREP parameters as CPEREP 
operands — essentially, identical to the way you would code them to run EREP 
under VSE or MVS. 


However, when running CPEREP, you cannot include the operands on the 
command line, because many of them exceed the record length allowed for CMS 


commands. Instead, you enter the operands using one of the following methods: 


e You can enter the operands individually in response to prompting by the 
system 


e You can put all the operands for a single report in a separate file whose name 
you include on the CPEREP command line 


e You can use the &STACK control statement to enter the operands automat- 
ically 


e You can use combinations of two of the above. 


The next several sections of this chapter describe in detail the methods of entering 
operands for CPEREP, including examples of each. 


C 


Invoking CPEREP 


Coding Rules 


Entering CPEREP Operands 


You can supply operands to CPEREP in any of several ways, depending on how 
automated you want the procedure to be. Regardless of the way you enter the 
operands, however, the invocation of CPEREP is the same. The entire sequence 
for invoking CPEREP is as follows: 


1. Log on to a virtual machine that has been established for the CE (normally, a 
Class F userID). 


2. IPL CMS. 


3. Issue FILEDEF statements for the files required by EREP, if they are not 
already defined to the system. 


4. Have the system operator mount any required tape volumes for use as input 
and output data sets. 


5. Issue the CPEREP command. 


6. Enter CPEREP operands via one of the methods detailed on the next several 
pages. 


When entering operands, you must follow these rules: 


@ Separate a keyword and its associated values from a following keyword 
operand by one or more blanks, or by a comma. (You can put each 
parameter/control statement on a separate line.) 


e Enter embedded commas, periods, and parentheses that define the extent of 
variable operands as shown in the CPEREP operand syntax in Figure 9-2 on 
page 9-7. 

@e You may enter operands in any sequence. 

@e When specifying an operand where the allowed values are Y and N, you may 


omit = Y, coding only the keyword itself. CPEREP always interprets this 
form of the operand as specifying YES, regardless of the default value. 
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Prompting Method 


Prompting Method 


The basic way to supply operands for CPEREP is to respond to its prompting 
messages. After you type CPEREP on the command line and press ENTER, the 
system prompts you with: 


ENTER PARAMETER STATEMENTS OR NULL TO PROCESS 


You then type in your CPEREP operands. If you fill up the entire command line 
before all the operands are entered, press ENTER again for another prompting 
message and a clear command line. You can continue in this way until all your 
operands for that report are entered. When finished, press ENTER to signal with 
a null command line the end of the string of operands. 


To invoke CPEREP using only EREP’s default values, respond to the first 
prompting message by pressing ENTER, to enter a null line. 


Prompting Method Example 
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The following example shows a complete CPEREP operation as initiated from the 
virtual machine console, starting with the logon step. It illustrates the prompting 
method of entering CPEREP operands. 


Lowercase letters indicate entries by the terminal user; uppercase letters indicate 
system responses. 


When execution is complete, the TOURIST output appears on the terminal screen 
unless you have requested another output class for the TOURIST data set. 


Note: Any ICF**** messages in the TOURIST output are from EREP; all the 
EREP messages are documented in Chapter 11, “EREP Messages.” CMS 
may also issue messages in the course of EREP processing, prefixed with 
DMSIFC or DMSREA. These, too, are in Chapter 11, “EREP 
Messages,” under “CPEREP Messages for VM Users” on page 11-48. 


In this example, the requested report output, consisting of Detail Edits and Sum- 
maries of all records containing the device type code for the 2310 DASD, is sent 
to the system printer. The records used for the report are copied onto the data 
set at virtual address TAPE 181. 


J 


CONSOLE ACTION 


logon 


ipl cms 


R; 


mount accum 181 please put ring in. 


TAPE 181 ATTACHED 


fi tourist terminal 

fi directwk disk erep cmsutl a 

fi ereppt print 

fi accdev tape sl (recfm vb blksize 12000 
fi accin disk erep hist a (recfm vb 


cperep 


ENTER PARAMETER STATEMENTS OR NULL TO PROCESS 


print=ps hist acc=y dev=(2310) 
ENTER PARAMETER STATEMENTS OR NULL TO PROCESS 


endparm 
share=XA.cpuser.ccux,share=XA.cpuser.ccuX 


ENTER PARAMETER STATEMENTS OR NULL TO PROCESS 


PRT FILE 2546 FROM userid SENT TO printaddr NOHOLD 


Prompting Method 


COMMENTS 


User logs on to the CE userID. 
User IPLs CMS 


The system indicates successful initialization 
of CMS. 


User requests a tape for CPEREP use. 181 
is the virtual address of the default 
ACCDEV tape. 


Note that, if both HIST and ACC functions 
are to be used, you must also request that 
the history tape be attached at address 182. 


User defines the files needed to run EREP 
from VM. You can allow these to default to 
VM system FILEDEFS. See “Defining Files 
for CPEREP” on page 4-49. 


Invoking CPEREP, without naming a 
control file. The operation defaults to the 
prompting method of operand entry. 


The system prompts the user for EREP 
parameters and control statements as oper- 
ands for the CPEREP command. 


User enters CPEREP operands 
The system prompts again for operand input. 


User enters more operands. 


The system prompts again for operand input. 


User enters a null line to start processing. 


The end of EREP processing is signalled by 
the CMS PRINT message. Any TOURIST 
messages generated by the EREP program or 
CMS would appear on the terminal screen 
because of the TOURIST FILEDEF. 
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File Entry Method 


File Entry Method 


File Entry Method Example 
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Create a file, using the system editor, that contains the operands you want in 
effect for this execution of CPEREP, and include the name, type and mode of the 
file on the CPEREP command line. Make sure there is a FILEDEF in effect for 
SYSIN with the same data set name as your operand file. The operands are 
arranged in the file according to the rules listed under “Entering CPEREP 
Operands” on page 9-8. Note that input records are truncated at column 71. 


To invoke CPEREP using only EREP’s default values, issue the SYSIN 
FILEDEF for an empty file. 


In practice, you will probably want to have several different files containing the 
various operand combinations needed to run CPEREP for your installation. See 
the User’s Guide for your system editor for information on how to create a file 
for the operands. 


The following EXEC illustrates the use of a separate file to enter CPEREP oper- 
ands. 


&TRACE ERR 

FILEDEF EREPPT PRINTER (NOCHANGE BLOCK 133 PERM 
FILEDEF TOURIST PRINTER (NOCHANGE BLOCK 133 PERM 
FILEDEF DIRECTWK DISK EREP CMSUT1 &DISK? 

FILEDEF ACCIN DISK HIST RECORDS A (RECFM VB 
FILEDEF SYSIN DISK EREP PARMS A (RECFM F 

EXEC CPEREP EREP PARMS A 

& EXIT 


The file named EREP PARMS A contains: 


HIST 

ACC=N 

TABSIZE=500K 

SYSEXN 

ENDPARM 

SHARE= (020402 .0736,220402.0736) 

SHARE= (020402 .0735,220402.0735) 

LIMIT 33XX,ALL=15 

LIMIT 3420,HR1600=025(1),HW1600=010(15) 
LIMIT 3420,VR1600=025(1) , VW1600=010(15) 
DASDID CPU=020402 ,CH=07,SCU=14,STR=0238 


In this example the requested System Exception report output and the TOURIST 
message output both go to the printer. The series of sample EXECs earlier in this 
chapter all use this method of entering operands. It avoids the necessity of re- 
typing complex EREP control statements each time you invoke CPEREP. 


Note, too, that the records for EREP to process are in a history file on disk. 


C 


Stacked Entry Method 


Stacked Entry Method 


The CMS EXEC &STACK control statement allows you to enter commands or 
operands as instream data before coding the CPEREP command. It is another 


way to avoid having to re-code parameters and control statements each time you 
run EREP. 


You precede each operand by “&STACK,” one to each input record. CPEREP 
reads the operands in the order in which you have stacked them. 


To invoke CPEREP from an EXEC using only EREP’s default values, code only 
a null &STACK statement in the EXEC. 


Stacked Entry Method Example 


The following example illustrates the use of the &STACK control statement 
within a CMS EXEC to enter operands for the CPEREP command. 


&TRACE ERR 

FILEDEF EREPPT PRINTER (NOCHANGE BLOCK 133 PERM 
FILEDEF TOURIST TERMINAL (NOCHANGE BLOCK 133 
FILEDEF DIRECTWK DISK EREP CMSUT1 &DISK? 
FILEDEF ACCIN DISK HIST RECORDS A (RECFM VB 
&STACK HIST 

&STACK ACC=N 

&STACK TABSIZE=500K 

&STACK SYSEXN 

&STACK ENDPARM 

&STACK SHARE=(020402.0736,220402.0736) 

&STACK SHARE=(020402.0735,220402.0735) 

&STACK LIMIT 33XX,ALL=15 

&STACK LIMIT 3420,HR1600=025(1),HW1600=010(15) 
&STACK LIMIT 3420,VR1600=025(1),VW1600=010(15) 
&STACK DASDID CPU=020402 ,CH=07,SCU=14,STR=0238 
& STACK 

EXEC CPEREP 

S&EXIT 


In this example, the EREP controls are inline, to be read by CPEREP in the 
order they are listed. Note the null &STACK statement following the DASDID 
statement. Without it, CPEREP would prompt the terminal user for more EREP 
control statements. 


The report output produced by this example is sent to the printer, but the 
TOURIST output appears on the terminal screen. 


See the User’s Guide for your version of CMS for information about coding and 
using EXECs. 
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Mixed Entry Method 


Mixed Entry Method 


You can combine the previous methods of entering CPEREP operands to make 
the process more efficient, yet flexible. For example, enter the CPEREP 
command followed by the name of a file containing operands, one of which is the 
TERMINAL operand. CPEREP reads the operands from the named file until it 
reaches TERMINAL. At this point, it reads no more input from the file; instead, 
it prompts the terminal user for operands. You can thus enter operands at the 
time of EREP’s execution to dynamically tailor a report to your immediate 
requirements. 


Note that the position of the TERMINAL operand is important: if it follows 
ENDPARM, you can enter only EREP control statements when prompted. 


Not coding a null &STACK statement following a series of stacked operands has 
the same effect; unless it encounters a null &STACK statement, CPEREP 
prompts the terminal user for further input after reading in the stacked operands. 


Mixed Entry Method Examples 
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The following examples show two ways to enter operands using the mixed entry 
method. 


1. With the TERMINAL operand in an input file: 


&TRACE ERR 

FILEDEF EREPPT PRINTER (NOCHANGE BLOCK 133 PERM 
FILEDEF TOURIST PRINTER (NOCHANGE BLOCK 133 PERM 
FILEDEF DIRECTWK DISK EREP CMSUT1 &DISK? 

FILEDEF ACCIN DISK HIST RECORDS A (RECFM VB 
FILEDEF SYSIN DISK EREP PARMS A (RECFM F 

EXEC CPEREP EREP PARMS A 

&EXIT 


The file named EREP PARMS A contains: 


PRINT=PT 
HIST 
ACC=N 
TYPE=M 
TERMINAL 


This EXEC invokes CPEREP to produce Detail Edit reports of all the MCH 
records in the history file (ACCIN — HIST RECORDS A). The reports and 
TOURIST output are being sent to the printer. 


The TERMINAL operand following the other EREP parameters causes 
CPEREP to prompt the user for more input. You could then enter a DATE 
parameter, for example, or the CPU parameter, to narrow further the 
selection of records from the history file. 


You could also enter SHARE or CONTROLLER control statements, if 
appropriate (they aren’t, in this example). In that case, you would first have 
to enter ENDPARM. 


Mixed Entry Method 


With no null &STACK statement in a CMS EXEC: 


&TRACE ERR 

FILEDEF EREPPT PRINTER (NOCHANGE BLOCK 133 PERM 
FILEDEF TOURIST PRINTER (NOCHANGE BLOCK 133 PERM 
FILEDEF DIRECTWK DISK EREP CMSUT1 &DISK? 

FILEDEF ACCIN DISK HIST RECORDS A (RECFM VB 
&STACK PRINT=PT HIST ACC=N 

EXEC CPEREP 

&EXIT 


This EXEC produces Detail Edit reports of all the records on input file HIST 
RECORDS A. In the absence of a null &STACK statement following the 
statement with parameters, CPEREP will prompt for more input. Then, you 
could specify the TYPE parameter, or DATE and/or TIME, or DEY, to limit 
the records EREP processes. Following ENDPARM, you could also enter 
SHARE or CONTROLLER statements. 


In this example, the report and TOURIST output are being sent to the 
printer. To change the destination of output, you must change the 
FILEDEFs for the output files. See “Defining Files for CPEREP” on 
page 4-49 for more information. 
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Chapter 10. Error Records for EREP 


This chapter contains reference information about the records EREP uses to 
produce its reports. 


The Error-Recording Process 


Each S/370 operating system writes error and operational records to its error- 
recording data set (ERDS). The records are created primarily for the hardware — 
processors and devices — that make up the S/370 data processing installation, 
although the operating system also creates some records to document its own 
processing. 


The ERDS is different for each operating system: 


e For VSE, it is system logical unit SYSREC, file name IJSYSRC, residing on 
the SYSRES disk. The data set is initialized by the IPL command SET 
RF=CREATE. See the System Management Guide for your VSE system. 


e For MVS systems, it is system data set SYS].LOGREC, residing on the 
system residence volume.! The data set is initialized by the IFCDIP00 service 
aid during system generation, and can be reinitialized at IPL. See the System 
Generation Reference manual for your MVS system. 


e For VM systems, it is the error-recording area assigned on the system resi- 


dence volume and initialized during system generation. See the Planning and 
System Generation guide for your VM facility. 


| For MVS/XA, LOGREC can be another cataloged data set, and need not be on the 
system residence volume. 
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ERDS Formats 


Record Formats 
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The records on a system’s ERDS must conform to a standard of both format and 
content, regardless of the system that records them. EREP assumes that the 
records it receives as input conform to the standard; it has only one map for each 
type of record. 


In this section of the book are mappings of the error and operational records. 
The contents of the various fields in the records are identified and described in 
general terms, because that is how EREP sees them. 


The mapping used to present the records in this section is: 


Offset Size (Bytes) Field 
Dec(Hex) Alignment (Bits) Name Description 


Offset is the numeric address of the field relative to the beginning of 
the data area. 


Dec(Hex) is the offset in decimal, followed by the hexadecimal equivalent 
in parentheses. For example: 16(10). 


Size (Bytes) is the field size in bytes. 
Alignment (Bits) shows the bit settings of switch or flag fields, as follows: 
indicates the eight bit positions (0-7) in a byte. 
For ease of scanning, the high-order (left-hand) 
four bits are separated from the low-order four 
bits. 
Xe... .... IS a reference to bit 0. 
1... .... indicates that bit 0 is on. 
O... .... indicates that bit 0 is off. 


..xx is a reference to bits 6 and 7. 


The record mappings include significant bit settings. Bits 
described as “reserved” are not significant for this release. 


Field Name is a label (acronym) that identifies the field. 


Description indicates how the field is used. Where the field’s use relates 
directly to a value you would code, the coded value is shown. 
Where the hexadecimal code for a particular bit setting would 
be helpful, it is shown separated from the rest of the description. 


ERDS Formats 


C ERDS Formats 


The error-recording data sets for the different operating systems are similarly for- 
matted. Each has a header record, followed by frame records if the installation 
includes 303X processors, followed by the individual error and operational 
records. The characteristics of each operating system dictate the exact format of 
the ERDS; the system manual that describes error-recording procedures provides 
more specific information. Following are brief descriptions of the parts of the 
ERDS not taken up by error records. 


The ERDS Header Record 


SYSREC, SYS1.LOGREC, and VM’s error-recording area (cylinders) each start 
with a header record that provides information to the system recording routines 
about the device on which the ERDS resides, where to write new records, and 
when the data set is getting full. The figures on the next few pages represent the 
header records for each system: 


e Figure 10-1 on page 10-4 shows the header record for SYSREC on count- 
key-data (CKD) devices 


e Figure 10-2 on page 10-5 shows the header record for SYSREC on fixed- 
block-architecture (FBA) devices 


e Figure 10-3 on page 10-6 shows the header record for SYS1.LOGREC 


e Figure 10-4 on page 10-7 shows the header record for the VM error- 
recording cylinder(s). 
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SYSREC (VSE) Header Record (CKD) 


The CKD Header Record for SYSREC ) 


This figure shows the format of the header record when IJSYSRC is on a count- 


Offset 
Dec(Hex) 


Size (bytes) 
Alignment (bits) 


0(0) 
2(2) 
6(6) 
10(A) 
11(B) 
18(12) 
20(14) 
22(16) 


29(1D) 
31(1F) 


33(21) 


34(22) 
38(26) 


39(27) 


Figure 10-1. 
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key-data device. 


Field 
Name 


CLASRC 
LOWLIMIT 
UPLIMIT 
TRKSPER 
RESTART 
BYTSREM 
TRKCAP 
LASTTR 


PUBNUM 
EWMCNT 


DEVCODE 


EWMTRK 
EWMSW 


FRAMES 
SFTYBYT 


CKD SYSREC Header Format 


Description 


Header record identifier. This field is set to X’FF00’ unless critical data has 

been destroyed. 

Address of low extent. Track address (in CCHH format) of first extent of 

SYSREC. 

Address of high extent. Track address (in CCHH format) of last extent of 

SYSREC. 

Highest addressable track for each cylinder on the volume containing 

SYSREC. 

Address of record entry area. Starting track address (in BBCCHHR 

format) for recording area on SYSREC. 

Remaining bytes on track: number of bytes remaining on the track upon 

which the last record entry was written. 

Total bytes on track. Number of bytes that can be written on a track of the 

volume containing SYSREC. 

Address of last record written. Track address (in BBCCHHR format) of 

last record written on SYSREC. 

Number of PUBS in the system. 

Warning count. Number of bytes remaining on early warning message 

track of SYSREC when 90% full point of data set is reached. When this is 

detected by a recording routine, it issues a message and turns on the early- 

warning-message switch at displacement 38. 

Device code. Code indicating device type of system volume on which 

SYSREC resides: 

Code Device 

01 2311 

02 2301 

03 2303 

04 2302 

06 2305 MOD 1 

07 2305 MOD 2 

08 2314 

09 3330 and 3333 MOD 1 or 3350 operating in 3330-1 compatibility 
mode 

OA 3340 and 3344 

OB 3350 native mode 

0C 3375 

0D 3330 and 3333 MOD 11 or 3350 operating in 3330-11 compatibility 
mode 


Early warning message track. Track address (in CCHH format) on which 
the 90% full point will be found. 

Switch byte: 

90% full point message has been issued. This switch is turned on by 
recording routine detecting 90% full point and is turned off by IFCEREP1 
when clearing SYSREC. 

An emergency recording has occurred. This switch is turned on when the 
system terminates because SYSREC is full. 

Machine-check and channel-check frames exist on SYSREC. 

Reserved. 

Check byte. Each bit in this field is set to 1 (X’FF’); used to check the 
validity of the header-record identifier. 





C 


The FBA Header Record for SYSREC 


Offset 
Dec(Hex) 


0(0) 


2(2) 
6(6) 
10(A) 
11(B) 


15(F) 
22(16) 


26(1A) 
33(21) 
34(22) 


38(26) 


39(27) 


Figure 10-2. FBA SYSREC Header Format 


Size (bytes) 
Alignment (bits) 


2 


aey AND AHA 


fhe 
: 
» 


SYSREC (VSE) Header Record (FBA) 


This figure shows the format of the header record when IJSYSRC is on a fixed- 
block-architecture device. 


Field 
Name 


CLASRC 


LOWLIMIT 
UPLIMIT 


RESTART 


LSTREC 


DEVCODE 


EWMTRK 
EWMSW 


FRAMES 
SFTYBYT 


Description 


Header record identifier. This field is set to X’FFO00’ unless critical data has 
been destroyed. 

Address of low extent. Block number of the first extent of SYSREC. 
Address of high extent. Block number of the last extent of SYSREC. 
Reserved. 

Address of record entry area. Block number of the start of the recording 
area of SYSREC. 

Reserved. 

Address of last record. Block number of the last record written on the 
recording area. 

Reserved. 

X’0F’. Device code for FBA device. 

Early-warning-message block. Block number on which the 90%-full point 
will be found. 

Switch byte: 

90% -full-point message has been issued. This switch is turned on by 
recording routine detecting 90% full point and is turned off by IFCEREP1 
when clearing SYSREC. 

An emergency recording has occurred. This switch is turned on when the 
system terminates because SYSREC is full. 

Machine-check and channel-check frames exist on SYSREC. 

Reserved. 

Check byte. Each bit in this field is set to 1 (X’FF’); used to check the 
validity of the header-record identifier. 
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SYS1.LOGREC (MVS) Header Record 


The Header Record for SYS1.LOGREC 


Offset 
Dec(Hex) 


0(0) 
2(2) 
6(6) 
10(A) 
11(B) 


18(12) 
20(14) 
22(16) 
29(1D) 
31(1F) 


33(21) 


34(22) 
38(26) 


39(27) 


Figure 10-3. SYS1.LOGREC Header Record 
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Field 
Name 


CLASRC 
LOWLIMIT 
UPLIMIT 
MSGCNT 
RESTART 


BYTSREM 
TRKCAP 
LASTTR 
TRKSPER 
EWMCNT 


DEVCODE 


EWMTRK 
EWMSW 





Description 


Header-record identifier. Each bit in this field is set to 1 unless critical data 
has been destroyed. 

Address of low extent. Track address (in CCHH format) of first extent of 
SYS1.LOGREC. 

Address of high extent. Track address (in CCHH format) of last extent of 
SYS1.LOGREC. 

Count of the number of times LOGREC-full message has been issued 
(maximum is 15). 

Address of record entry area, and address of time-stamp record. Starting 
track address (in BBCCHHR format) of the recording area on 
SYS1.LOGREC. If a time-stamp record is present, it begins at the address 
pointed to by this field. 

Remaining bytes on track. Number of bytes remaining on the track upon 
which the last record entry was written. 

Total bytes on track. Number of bytes that can be written on a track of the 
volume containing SYS1.LOGREC. 

Address of last record written. Track address (in BBCCHHR format) of 
last record written on SYS1.LOGREC. 

Highest addressable track for each cylinder on volume containing 
SYS1.LOGREC. 

Warning count. Number of bytes remaining on early-warning-message 
track of SYS1.LOGREC when 90%-full point of data set is reached. When 
this is detected by a recording routine, it issues a message and turns on the 
early-warning-message switch at displacement 38. 

Device code, indicating the device type of the volume on which 
SYS1.LOGREC resides: 


Code Device 


2311 (not supported by VS) . 
2301 ) 


2303 

2302 

2305 MOD 1 

2305 MOD 2 

2314 

3330 and 3333 MOD 1 or 3350 operating in 3330-1 compatibility 
mode 

3340 and 3344 

3350 native mode 

3375 

3330 and 3333 MOD 11 or 3350 operating in 3330-11 compatibility 
mode 

3380 


Early-warning-message track. Track address (in CCHH format) on which 
90% full point for data set exists. 

Switch byte: 

90%-full-point message has been issued. This switch is turned on by the 
recording routine detecting 90% full point and is turned off by IFCEREP1 
when clearing SYS1.LOGREC. 

Machine-check and channel-check frames exist on SYS1.LOGREC. 
Reserved. 

Check byte. Each bit in this field is set to 1 (X’FF’); the field is used to 
check the validity of the header-record identifier. 


VM ERDS Header Record 


: | The VM Error-Recording Area (Cylinder) Header 


Size (bytes) Field 
Alignment (bits) Name 


4 RECCCPD 
2 RECNXT 

1 RECFLAG1 
1 
1 


RECPAGIU 
RECPAGFR 


RECPAGFL 


RECPAGER 
RECPAGFA 


RECFLAG2 
RECPAGFM 


0000 0000 RECPAGDN 


Description 


Address of this cylinder. 

Displacement to the next available space for records. 

Record usage flags: 

The page contains valid data. 

The page is cleared. This bit is set by EREP when it clears the error- 
recording area. 


| The page is full. When this bit is set, a message is issued to the operator to 


clear the error-recording area. 

The next page is unreadable. 

Frame records exist for this page. 

Reserved. 

Record format flags: 

The cylinder is being formatted. This bit is turned on in the first page of a 
recording cylinder while the cylinder is being formatted. The field is reset 
only when all pages are cleared. 

The cylinder has been formatted. If this field is non-zero, the cylinder is in 
the process of being formatted. 





Figure 10-4. VM Error-Recording Cylinder Header 
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Other ERDS Data 


Time-Stamp Record for IPL Records Jo 


For an MVS or MVS/XA system, the first record following the ERDS header on 
SYS1.LOGREC is a time-stamp record used by the error-recording routines when 
they are building IPL records.? The current date and time information in an IPL 
record allows you to measure the interval between system termination and re- 
initialization. 


The time-stamp record consists of a standard 24-byte header plus 16 bytes that 
are reserved for system use. Within the header, at offsets 8 and 12, are the system 
date and time fields. These fields are updated at pre-set intervals, so the date and 
time are kept current. 


When building an IPL record, the recording routines take the current date and 
time from the time-stamp record and put them in the system date and time fields 
of the IPL record header. 


Frames for 303X Machine- and Channel-Check Records 


When an installation includes processors from the 303X family, the ERDS con- 
tains special frame records for EREP to use in processing and formatting the 
MCH and CCH records from the processors. The frames govern the formatting 
of model-dependent data. 


The frame records are written in a reserved area of the ERDS. They are not 
erased or changed by the EREP ZERO parameter; you must reinitialize the » 
ERDS in order to change the frame records. 


The frame records consist of a standard 24-byte record header followed by 1920 
bytes of frame instructions that direct EREP in processing the MCH and CCH 
records for its reports. 


When VSE writes frame records, it puts identifying information into the record- 
dependent switches in the record header, so the records can be subdivided if nec- 
essary. 


See Chapter 20, “Processors (CPUs)” in Part 4, “Product-Dependent 
Information” for more specific information about the 303X frame records and 
how they are updated. 


2 In early versions of the MVS system, time-stamp recording only takes place when 3 
the system includes the RDE option. In later versions, some of the functions of 
RDE are included in the base control program. 
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Other ERDS Data 


Cc Information in Error and Operational Records 


The records on the system’s ERDS are of two types: 


1. 


Hardware and software errors, which reflect the failure and recovery of 
processors, channels, I/O devices, and operating system software. 


Software operational data, which indicates the time and circumstances of the 
failures, as well as of other conditions. 


While the records reflect different events and are of different lengths, they all 
contain the following kinds of information: 


Relevant system information at the time the record was generated 
Device hardware status at the time the record was generated 
Results of any device/control unit recovery attempt 

Results of any software system recovery attempt 

Statistical data about device usage and/or recoverable errors 


Each record begins with a standard 24-byte header, which contains the informa- 
tion needed to identify the type and origin of the record: 


Type information includes the specific type of the record, the specific source of 
the record, the general reason the record was created, and special record- 
dependent data. 


Origin information includes the operating system under which the record was 
generated, the date and time the record was generated, and the identity of the 
processor (CPU) on which the record was generated. 


Note: For CCH, MCH and OBR records, the processor generating the record is 


also the processor associated with the error. In a tightly-coupled multiproc- 
essing environment, this is not necessarily true for other types of records. 
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Standard Record Header 


The Standard Record Header: Data Common to All Record Types J 


The origin information and some of the type information is the same for all 
records; Figure 10-5 shows the contents of the fields that are the same. In the 
mappings on later pages, the record header (the first 24 bytes of the record) is 
separated from the rest of the record by the phrase END OF STANDARD 
HEADER. 


Offset Size (bytes) 
Dec(Hex) Alignment (bits) Description 


(1) l System/release level: 
000. .... OS/360. 
O01. .... DOS (VSE systems). 
010... OS/VSI1. 
Oll. ou... CP67, VM/370, and later VM systems. 
100. .... OS/VS2 and later MVS systems. 
ae Sere Reserved. 
XXXX Release level (0-1F). 
1 XxxSMS Record-independent switches: 
i ees More records follow. 
Oise kee Last record. 
X.. Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 
Record truncated. 
370-XA mode record. 
TIME macro used (MVS). 
Time in timer units (VSE). 
Reserved. 


xxxRCDCT Record count: 
Sequence number of this physical record. 
Total number of physical records in this logical record. 


8(8) xxxDT System date and time, as: 

8(8) xxxDATE System date of failure. 

12(C) XxxTIME System time of failure. 

16(10) xxxCPUID CPU identification, as: 

16(10) Xxx VER Machine version code: 
Reserved. 
Version I CPUs. 

se » ake Version II CPUs. 

17(11) XxxSER CPU serial number. 

20(14) xxxMOD CPU machine model number (3033, 4341, etc.). 

22(16) xxxCEL Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 





Figure 10-5. Header Data Fields Common To All Records 


10-10 EREP User’s Guide 


Record Type Codes 


Cc The Record Type/Class Codes 


The first field in the standard record header is a one-byte hexadecimal code that 
identifies the type (or class) and source of the record. 


While all three $/370 operating systems create identical records, they do not all 
record every possible kind of record. Some record types are not relevant for all 
S/370 operating systems; and some operating systems simply do not support the 
recording of all record types. See “VM Notes” in Part 4, “Product-Dependent 
Information.” 


Figure 10-6 on page 10-12 shows the record types that each of the operating 
systems records on its ERDS, listed according to the record class code. 


Note that, wlien VM writes a record, it can be doing so in its own behalf or on 
behalf of another operating system running in a virtual machine. 


Note, also, that MVS creates different versions of some records. 
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Record Type Codes 










Record Type Code and Description 
1X Machine Check (MCH) 
10 MCH X X Xx 
13 MCH in multiple storage environment X x? 
xX x3 








2X Channel Check (CCH) 
20 CCH 

21 CCH in multiple storage environment 
23 SLH subchannel logout 
25 CRW channel report word 


3X Unit Check (OBR) 


X 

X 1 
x4 
x4 














30 OBR xX x x? 
34 TCAM OBR x 
36 VITAM OBR x x 
3A DPA OBR x 






4X Software Error (SFT) 
40 Software-detected 
42 Hardware-detected 
44 Operator-detected 
48 Hardware-detected hardware 
4F Lost record 


5X System Initialization (IPL) 
50 IPL », 4 X 
6X Reconfiguration (DDR) 
60 DDR x! x? 


TX Missing Interrupt (MIH) 
70 MIH x6 x! x3 
71 MIX x4 
8X Recovery/Termination ele] 
», 4 », 4 
x! 
x! 










mr x 













80 EOD 
81 Non-restartable wait state (MCH) 
84 Restartable wait state (JOS) 










9X Non-Standard (MDR) ie do 
90 SVC X X 
91 Miscellaneous data recorder X xX x? 


Figure 10-6. Record Types and Systems Recording Them 


Notes: 


MVS only 

For both VM and the virtual machine 

For VM only; SVC 76 is reflected back to the virtual machine 
MVS/XA only 

For the virtual machine only 

VSE/Advanced Functions only 


Sy 
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Record Mappings 


cC Record Mappings 


The figures on the following pages show the layouts of each of the general record 
types, accompanied by general descriptions. The record formats are in alphabet- 
ical order. 


Information about frame records (AO and BO) is under “Frames for 303X 
Machine- and Channel-Check Records” on page 10-8. 
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CCH Record 


Channel Check (CCH) Record > 


In the $/370 environment, the operating system writes a CCH record when a 
channel failure occurs but does not terminate the system control program. The 
errors recorded include channel control checks, channel data checks, and interface 
control checks. 

MVS writes an extended version of the CCH record; see offset 80. 


Figure 10-7 shows the format of the CCH record. 
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Offset 
Dec(Hex) 


0(0) 


1(1) 


6(6) 
7(7) 
8(8) 


16(10) 
16(10) 


Figure 10-7 (Part 1 of 3). 


Size (bytes) 
Alignment (bits) 


Field 
Name 


CCHKEY1 


CCHKEY2 


CCHSMS 


CCHPASS 


CCHSWI1 


CCHSW2 


CCHSWS 


CCHSFTSW 


CCHRCDCT 


CCHDT 


CCHCPUID 
CCHVER 





CCH Record 


Description 


Class/Source: 

CCH record; type = X’20’. 

CCH record recorded in multiple virtual storage environment (MVS and 
later VS2 releases); type = X’21’. 

System/release level. 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches. 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (OS/VS). 

Time in timer units (VSE). 

Passed, recovery status. VM passed error to guest. 

Reserved. 

Record-dependent switches: 

Switch 1 (all systems): 

Operator message required. 

Record incomplete. 

System terminated (Not used by MVS). 

Channel unsupported or failed to log. 

Illegal CUA. 

Portion of data overlaid. 

ERP in progress. 

Reserved. 

CCH internal switches from PCCA (MVS only): 

Command register parity is valid. 

No recording by CCH. 

CCH FRR in FRR stack. 

Record SYS1.LOGREC record only. 

Attention bit in CSW is on. 

ERPIB has already been created for error. 

UCB is invalid. 

Reserved. 

CCH internal switches from PCCA (MVS only): 

I/O restart function required. 

Alternate return to I/O supervisor requested (CCH retry not required). 
Channel analysis module is unavailable to CCH to analyze error. 
Channel failed to log. 

Channel availability table (CAT) entry is valid, but channel type is not 
recognized. 

Channel reconfiguration hardware (CRH) active on channel at time of 
channel error. 

Recovery status bits. See “3090 Processor” on page 20-7. 

Invalid or, for VM, passed to guest. 

Hard fail. 

Degrade fail. 

Soft fail. 

Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 

Reserved. 

System date and time of failure. See Figure 10-5 on page 10-10 for the 
details in these fields. 

CPU identification: 

Machine version code. 


Channel Check (CCH) Record Format 
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CCH Record 


Offset 
Dec(Hex) 


Size (bytes) 
Alignment (bits) 


17(11) 3 


20(14) 
22(16) 
24(18) 
32(20) 


48(30) 
56(38) 
64(40) 


68(44) 


72(48) 


76(4C) 


78(4E) 
80(50) 


Figure 10-7 (Part 2 of 3). 
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Field 
Name 


CCHSER 


CCHMOD 


CCHCEL 


CCHJOBID 


CCHATIO 


CCHFCCW 
CCHCSW 
CCHECSW 


CCHCODE 


CCHTYPE 


CCHCUA 


CCHCUA2 


CCHLOG 
TIOADDR 


Description 
CPU serial number. 


Note: If bit 5 of switch 3 (CCHSWS) is set, indicating channel reconfigura- 
tion hardware (CRH) is active, the following information applies (for 
IBM Model 168 MP CPUs only): 


1. The CPU serial number field (offset 17 decimal) is that of the 

“live” or running CPU and not that of the CPU to which the 
channel is actually attached (i.e., the “dead” CPU). 
The channel set ID and channel status fields of the MP informa- 
tion area (offset 88 decimal plus a variable logout length identi- 
fied by labels CCHCMPPA and CCHCMPCS) always reflect 
the address and channel status of the channel set connected to the 
dead CPU. That is, the first entry for these fields is for the dead 
CPU, and the second entry is for the live CPU (the one on which 
CRH receives control). 

CPU machine model number (3033, 4341, etc.). 

Maximum length of machine- (CPU) dependent, machine check extended 

logout area. 


END OF STANDARD HEADER 


Alphameric name assigned to job (as identified, for example, by a jobname 
on a JCL JOB statement) being executed and/or requesting service at time 
of channel-detected error. 

List of active 1/O units or addresses, one to eight devices, on failing channel 
that were found to be busy (device end outstanding). List includes device 
address associated with failure. 

Last real CCW executed before failure. 

Contents of CSW that was stored following detection of I/O failure. 
Contents of extended CSW (limited channel logout), or last four bytes of 
ERPIB for 28XX channels. 

Code for the device type of the failing device. The first two bytes are VSE 
PUB bytes 4 and 5; the second two bytes are MVS UCB device class and 
type bytes 18 and 19 (decimal). See “Device Type Codes in the OBR 
Record” on page 12-13 for a list of the UCB codes. 

Channel type associated with the failing channel: 


Code Meaning 


00 Channel unknown (CCH provides a 155II channel analysis by 
default, assuming the channel adheres to System/370 channel design.) 

01 Integrated multiplexor (MPX) 

02 Integrated selector 

03 Integrated block MPX 

04 Reserved 

05 Standalone selector (2860) 

06 Standalone MPX (2870) 

07 Standalone block MPX (2880) 

08 Selector channel (2880) 

0A Integrated file adaptor 

OF Channel unknown 


The channel and unit address of the last path used to address the failing 
device — the failing path and the path over which the sense was issued and 
data retrieved. 

The last two bytes, right-justified, of the CUA stored by hardware in 
machine storage locations 186-187 (decimal). VSE systems set bit 0 of the 
first byte on to indicate to EREP that the I/O device is invalid. 

Maximum length of the channel logout that begins at offset 80 or 84 
(decimal). 

In EC-mode records: CUA, right-justified, as stored by hardware in 
machine storage locations 186-187. In records with this field, the channel 
logout begins at offset 84. In VSE and MVS records, and for 28XX and 
303X channels, there is no TIOADDR field, and the CHNLOG field begins 
at offset 80. 





Channel Check (CCH) Record Format 


Offset Size (bytes) Field 
Dec(Hex) Alignment (bits) Name 


80(50) Variable CHNLOG 


Variable CCHCFT 


CCHMPNO 
ariable CCHMP 


CCHMPPA 
CCHMPCS 





CCH Record 


Description 


Machine-dependent channel logout associated with failure that caused 
channel check. Logout size is model- and channel-dependent: 


Channel Length (Bytes) 


2860 24 

2870 24 

2880 112 

135 24 

145 96 (maximum) 
155II/158 0 

16511/168 0 
303X 576 
43XX 0 
308X 0 
3090 0 


The remainder of this record is created only by MVS. 


CCH footprints: for use in debugging suspected CCH problems. 
Reserved. 

Number of online processors (CPUs), in hexadecimal. 

Multiprocessing information that consists of a variable number of 
CCHMPPA and CCHMPCS fields. The number of fields corresponds to 
the number of online CPUs in field CCHMPNO. 


Note: The following two fields, CCHMPPA and CCHMPCS, represent a 
format that is repeated a variable number of times within field 
CCHMP. The first CCHMPPA/CCHMPCS pair belongs to the 
CPU with the failing channel. 

Channel set ID or CPU address. 

Channel status for each channel (0-15) associated with the system. Each 

channel, beginning with channel 0 as the high-order bit, is represented by a 

one-bit code (0 = online, 1 = offline). 


Figure 10-7 (Part 3 of 3). Channel Check (CCH) Record Format 
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CRW Record 


Channel Report Word (CRW) Record 


In a S/370-XA environment, the channel report word (CRW) describes channel 
incidents reported through machine checks. The CRW specifies the error environ- 
ment and the severity of the error. 


As part of the recovery process, MVS/XA assigns a unique sequence number to 
each CRW it retrieves, and includes the number in the CRW record it builds for 
SYSI1.LOGREC. If the same error environment produces more than one CRW, 
MVS/XA associates subsequent sequence numbers with the number it assigned to 
the first CRW. 


Figure 10-8 shows the format of the CRW record created by MVS/XA. 
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Offset 
Dec(Hex) 


0(0) 
1(1) 


3(3) 


6(6) 


1(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


Figure 10-8 (Part 1 of 2). 


Size (bytes) 
Alignment (bits) 


Field 
Name 


CRWKEY 1 
CRWKEY2 


DOS (VSE 
systems). 


CRWSMS 


CRWBYTEI 
CRWBYTE2 
CRWBYTE3 
CRWRCDCT 


CRWDT 
CRWDATE 
CRWTIME 
CRWCPUID 
CRWVER 


CRWSER 
CRWMOD 
CRWCEL 





CRW Record 


Description 


Class/Source: 

CRW record; type = X’25’. 
System/release level: 
OS/360. 


OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Reserved. 

Record-dependent switches: 

Reserved. 

Reserved. 

Reserved. 

Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 
Reserved. 

System date and time, as: 

System date of failure. 

System time of failure. 

CPU identification, as: 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 


END OF STANDARD HEADER 


Channel Report Word (CRW) Record Format 
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CRW Record 


Offset Size (bytes) Field 
Dec(Hex) | Alignment (bits) | Name Description 


24(18) CRWMODUL CSECT name of module doing recording. 
32(20) CRWRECCD CRW recording code; identifies the format of the variable portion of the 
record. 
33(21) CRWFLAGI Flag byte 1: 
> wae CRWHARD Hardware-stored CRW. 
CRWSOFT Software-created CRW. 
Reserved. 
bf. bes CRWINVAL Invalid CRW. 
34(22) CRWFLAG2 Flag byte 2. 
35(23) CRWCODE CRW Origin Code: 
CRW origin unknown. 
0001 CRW-pending machine check. 
0010 System-damage machine check. 
0011 Alternate CPU recovery. 
0100 Reserved. 
0101 Reserved. 
0110 Hot I/O: Recover channel path. 
0000 0111 Hot I/O: Remove channel path. 
0000 1000 Vary channel path - forced. 
X09’ - X’FF’ Reserved. 
CRWCP Processor address on which the CRW was retrieved. 
Reserved. 
CRWCRW Channel report word. 
CRWDEV Device number (binary). 
Reserved. 
CRWDEPEN Device- and system-dependent data. For example, for MVS/XA, the fields 
contain: 
CRWSEQNO CRW sequence number. 
CRWASEQN Associated CRW sequence number. 
CRWDEVST UCB device status flags; zero if UCB not available. 
CRWPMCW Path management control word; zero if UCB not available. 
CRWCHPCT Channel path recovery count; zero if UCB not available. 
Reserved. 
CRWLEVEL UCB level value; zero if UCB not available. 
CRWLVMSK UCB level bit mask; zero if UCB not available. 
CRWSCHRC UCB subchannel recovery anchor; zero if UCB not available. 
Reserved. 
CRWICHPT ICHPT flags associated with the CRW channel path ID. 
CRWISDT Copy of the IOS interrupt subclass definition table. 


36(24) 
38(26) 
40(28) 
44(2C) 
46(2E) 
48(30) 


48(30) 
52(34) 
56(38) 
58(3A) 
60(3C) 
61(3D) 
63(3F) 
64(40) 
68(44) 
72(48) 
73(49) 
74(4A) 


Oe Phe NK NN AA fWZJNNANN 





Figure 10-8 (Part 2 of 2). Channel Report Word (CRW) Record Format 
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DDR Record 


C Dynamic Device Reconfiguration (DDR) Record 


MVS creates a DDR record for each operator-initiated or system-initiated swap 
between direct-access devices having buffered logs and demountable disk packs 
(such as the IBM 3330, 3330 MOD 11, and 3340 devices), and between magnetic 
tape devices. 


The DDR record identifies the physical devices involved in the swap. Figure 10-9 
shows the format of the DDR record. 
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DDR Record 



















Offset 
Dec(Hex) 


0(0) 
1(1) 


Field 
Name 


Size (bytes) 
Alignment (bits) 








Description 






















1 
1. 
l 


DDRKEY!1 Class/source: 

DDR record; type = X’60’. 

System/release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 
TIME macro used (MVS). 
Time in timer units (VSE). 
Reserved. 
Record-dependent switches: 















DDRKEY2 




















DDRSMS 





















DDRSW2 





Primary storage reconfiguration. 

Secondary storage reconfiguration. 

Operator requested reconfiguration. 

Permanent error caused reconfiguration. 

Reserved. 

Reserved. 

Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 
Reserved. 

System date and time of incident: 

System date of failure. 

System time of failure. 

CPU identification, as: 

Machine version code: 

Reserved. 

Version I CPUs. 

Version IT CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 

























seas XXX 
Bytes 1 and 2 
l 
XXXX 
















6(6) DDRRCDCT 


















XXXX 









1(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 









DDRDT 
DDRDATE 
DDRTIME 
DDRCPUID 
DDRVER 


























17(11) 
20(14) 
22(16) 


DDRSER 
DDRMOD 
DDRCEL 






END OF STANDARD HEADER 









DDRJOBID 





Name of job using ‘FROM’ device. Valid only for a system-initiated swap 
for a permanent error or operator-initiated tape swaps. 

Volume ID (VOLSER) of volume mounted on ‘FROM’ swap device. 
Volume ID (VOLSER) of volume mounted on ‘TO’ swap device. Field is 
zero if no volume is mounted on ‘TO’ device. 

Physical ID (not address) of “FROM” device. (DASD only.) 

Primary CUA or device number of ‘FROM’ device. 

Device type of ‘FROM’ device. 

Physical ID (not address) of ‘TO’ device. (DASD only.) 

Primary CUA or device number of ‘TO’ device. 

Device type of ‘TO’ device. 





24(18) 





















32(20) 
38(26) 


DDRVOLI 
DDRVOL2 




































DDRFPHD 
DDRFCUA 
DDRFDEV 
DDRTOPHD 
DDRTOCUA 
DDRTODEV 


44(2C) 
45(2D) 
48(30) 
52(34) 
53(35) 
56(38) 





Figure 10-9. Dynamic Device Reconfiguration (DDR) Record Format 
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EOD Record 


: Recovery/Termination (EOD) Record 

This record, type X’8X’, is used differently by different operating systems: 

e Both MVS and VSE systems write type X’80’ records to indicate that the 
system terminated normally under program control, at the request of the 


operator (HALT EOD). This orginal record type is the source for the 
“EOD” prefixes on field names in the mapping. 


e MVS and MVS/XA also write type X’8X’ records to document abnormal ter- 
minations: 


— The type X’81’ record is written when the system is put in a non- 
restartable wait by the operating system following a machine check. 


— The type X’84’ record indicates a restartable wait state requiring operator 
intervention. Examples of this condition are hot I/O and intervention 
required on a paging pack. 


The recovery/ termination record contains information relating to the cause of ter- 
mination and system environmental information. 


If the record is documenting normal termination, it consists only of the 24-byte 
header. In a record written for abnormal termination, the header is followed by 
fields of variable length containing data relevant to the system termination or wait 


( state codes. 


Figure 10-10 on page 10-24 shows the format of the recovery/termination record. 


Chapter 10. Records for EREP 10-23 





EOD Record 


Size (bytes) 
Alignment (bits) 


3(3) 
4(4) 
5(5) 
6(6) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


l 
l 
l 
2 
8 
4 
4 
8 
l 


~ OR 


17(11) 
20(14) 
22(16) 


24(18) Variable 
24(18) 4 
28(1C) 4 
32(20) Variable 


Field 
Name 


EODKEY1 


EODKEY2 


EODSMS 


EODDEV 


EODDT 
EODDATE 
EODTIME 
EODCPUID 
EODVER 


EODSER 
EODMOD 
EODCEL 


Description 


Class/Source: 

EOD Record; type = X’80’. 

MCH-forced termination (non-restartable wait); type = X’81’. 
IOS-forced termination (restartable wait); type = X’84’. 
System /release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Reserved. 

Record-dependent switches; not used for this record 

MDR device class of failing device, if any. 

Incremental release number (alphameric) of operating system. 
Reserved. 

System date and time, as: 

System date of failure. 

System time of failure. 

CPU identification. 

Machine version code: 

Reserved. 

Version ] CPUs. 

Version I] CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 

Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 


END OF STANDARD HEADER 


Information for abnormal termination records only. (See note.) 
Length, plus 8, of data field. 

Wait state code. 

Data. 


Note: If the wait state code is 66, 67, 68, 69 or 6A, MVS hot I/O recovery 
processing writes this termination record. A 32-byte data field con- 
tains the SCD entry for the channel with the “hot” condition (see the 
MVS or MVS/XA Debugging Handbook for a detailed description of 
the SCD). For other wait state codes that use these fields, the length 
of the data field varies. 





Figure 10-10. Recovery/Termination Record Format 
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c 


IPL Record 


System Initialization (IPL) Record 


Both OS/VS and VSE write IPL records to document operating system initializa- 
tion. MVS, MVS/XA and VSE/Advanced Functions always write the record, 
while other OS/VS and VSE systems do so only if the RDE (reliability data 
extractor) option is in effect. 


Under MVS, an IPL record is also generated to provide information about power- 
line disturbances that cause system termination. 


If the RDE option is in effect, the operator is prompted by a message (IFBO10D, 
in MVS) to supply a code for the reason for the IPL and for the subsystem 
responsible for the IPL. These are then included in the record when it is written 
to the ERDS. 


Figure 10-11 shows the format of the IPL record itself; Figure 10-12 on 

page 10-27 shows the reason codes that can be associated with IPLs, and 

Figure 10-13 on page 10-27 shows the codes for the responsible subsystems. A 
subsystem code is meaningful only when the reason code indicates that an IBM 
product was responsible for the IPL. See SPL: SYSI.LOGREC Error Recording 
for MVS or MVS/XA and VSE/Advanced Functions System Management Guide. 
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IPL Record 


Size (bytes) 
Alignment (bits) 


3(3) 
5(5) 
6(6) 
8(8) 
8(8) 
12(C) 
16(C) 
16(10) 


2 
l 
2 
8 
4 
4 
8 
l 
XXXX 


17(11) 
20(14) 
22(16) 


24(18) 
25(19) 
28(1C) 
30(1E) 
32(20) 


40(28) 
44(2C) 
48(30) 


Figure 10-11. 
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Field 
Name 


IPLKEY1 
IPLKEY2 


IPLSMS 


IPLDT 
IPLDATE 
IPLTIME 
IPLCPUID 
IPLVER 


IPLSER 
IPLMOD 
IPLCEL 


IPLSYSID 


IPLREAS 
IPLCHNM 
IPLCHAN 


IPLHADDR 


IPLSDATE 
IPLSTIME 


Description 


Class/Source: 

IPL Record; type = X’50’ 

System/release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (OS/VS). 

Time in timer units (VSE). 

Reserved. 

Reserved. 

Incremental release number (alphameric) of operating system. 
Reserved. 

System date and time when record was created: 

System date of failure. 

System time of failure. 

CPU identification: 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 

Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 


END OF STANDARD HEADER 


Device type or program that caused restart. See Figure 10-13. 

Not used for IPL record. 

Alphameric code representing the reason for IPL. See Figure 10-12. 
Channel map. 

Channel type assignment at IPL. See the CCH record for the channel type 
codes. 


Note: The channel assignment table is not used for 370-XA. 

Address of the last valid byte of storage found at IPL time. (MVS only.) 
Time-stamp date. (MVS only.) 

Time-stamp time. (MVS only.) 





System Initialization (IPL) Record Format 


IPL Record 


IPL Reason Codes 


Normal system initialization. 
IE IBM hardware/programming System restarted after a stop caused by a hardware failure or IBM programming 
problem, CE/PSR not required problem, but a CE/PSR was not required. 
IBM hardware/programming System restarted after a stop caused by a hardware failure or IBM programming 
problem, CE/PSR required problem, and it was necessary for a CE/PSR to correct problem. 
An IBM hardware unit failed because of faulty or damaged media (such as a 
damaged tape or disk). 


An undetermined hardware or software failure. 
}OP | Operational An operator error or procedural problem. 


UP User program A program other than an IBM-supplied system control program or programming 
product failed in such a way as to cause a system restart. 

EN Environmental A failure other than hardware/software or operational caused system to be restarted 
(power failure, air conditioning, etc.). 


CE/PSR has system System restarted at CE/PSR request to correct problem. 
Operator replied “U” or entered a nul! line in response to message IFBO10D. 


Figure 10-12. IPL Reason Codes 













IPL Subsystem ID Codes 


io Subsystem Name Description/Components 


[oo [Null Subsystem is unknown or subsystem code fs not required by reasou code. 
[10 | Processor SC CPU, channels, storage units, operator consoles, 
[60 [ MICRIOCR | Magnetic ink (MICR) and optical (OCR) character recogaition devices 
|70__| Teleprocessing | Teleprocessing devices and their control units, = 
| 80. | Graphics/Display/Audio sd Graphic, display, and audio devices. 

|90__| IBM System Control Program __| IBM programming system. 

|91__ | IBM Programming Product____| IBM programming products such as FORTRAN, COBOL, or RPG. 


Figure 10-13. Subsystem ID Codes for IPL 
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MICH Record 


Machine Check (MCH) Record 


All three operating systems write MCH records to document the occurrence of 
processor, storage, storage key or timing facility (external damage) failures. 


The records are written in response to a machine check interrupt, which can be 
for one of three reasons: 


1. The problem was recovered by the hardware or (for MVS systems only) 
recovered by the software. 


2. The problem was not corrected by hardware. For MVS, a hard machine 
check is one that could not be corrected or circumvented, so the software 
recovery routines were given control for the task. 

3. The problem resulted in the loss of a processor. 

Figure 10-14 shows the MCH record format for systems other than MVS. The 


MVS systems write an extended form of the MCH record; Figure 10-15 on 
page 10-31 shows the format of the MVS version of the record. 
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C 


C 


Non-MVS MCH Record Format 


Offset Size (bytes) 
Dec(Hex) Alignment (bits) 


0(0) 


1(1) 


4(4) 
6(6) 


7(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


24(18) 
32(20) 
40(28) 
48(30) 


Figure 10-14 (Part 1 of 2). 


Field 
Name 


MCHKEY!1 


MCHKEY2 


MCHSMS 


MCHPASS 


MCHSW2 
MCHSYSTR 


MCHSYSTM 
MCHSFTSW 


MCHRCDCT 


MCHDT 
xxxDATE 
Xxx TIME 
MCHCPUID 
MCHVER 


MCHSER 
MCHMOD 
MCHCEL 


MCHPGMID 
MCHJOBID 
MCHOPSW 
MCHILOG 





MCH Record 


Description 


Class/Source: 

MCH record; type = X’10’. 

Generated by diagnostic program = X11’. 

Generated by cycle trace (0168 only) = X’14’. 
System/release level: 

OS/360. 

DOS (VSE systems). 

OS/VSI1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Passed, recovery status. VM passed error to guest. 
Reserved. 

Record-dependent switches: 

Short form of record; only MCIC portion of model-independent logout. 
Reserved. 

System terminated by MCH. 

Reserved. 

Recovery status bits. See “3090 Processor” on page 20-7. 
Invalid or, for VM, passed to guest. 

Degrade fail. 

Soft fail. 

Hard fail. 

Reserved. 

Reserved. 

Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 
Reserved. 

System date and time of failure: 

System date of failure. 

System time of failure. 

CPU identification: 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 


Note: This field is meaningful only for records created in S/370 operating 
mode. 


END OF STANDARD HEADER 


Program (module) being processed at the time of failure. 

Job executing at time of failure. 

Machine check old PSW from storage locations 48-55. 
Machine-independent logout. Data from storage locations 232 - 511: 


Machine Check (MCH) Record Format - Non-MVS 
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MCH Record 


Offset 
Dec(Hex) 


Size (bytes) 
Alignment (bits) 


48(30) 8 


48(30) Byte 0 


49(31) 


50(32) 


51(33) 


52(34) 
53(35) 


54(36) 
56(38) 
64(40) 
68(44) 


328(148) Variable 


Variable Variable 


Figure 10-14 (Part 2 of 2). 
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Field 
Name 


MCHMCIC 


MCHMCICO0 
MCHMFSD 
MCHMFPD 
MCHMFSR 
MCHMFTD 
MCHMFCD 
MCHMFED 


MCHMFDG 
MCHMCIC1 
MCHMFWN 


MCHMPCRW 


MCHMCHSD 


MCHMIBU 
MCHMIDY 
MCHMCIC2 
MCHMFSE 
MCHMFSC 
MCHMFKE 
MCHMDFDS 
MCHMVWP 
MCHMVMS 
MCHMVPM 
MCHMVIA 
MCHMCIC3 
MCHMVFA 
MCHMVRC 
MCHMVEC 
MCHMVFP 
MCHMVGR 
MCHMVCR 
MCHMVLG 
MCHMVST 
MCHMCIC4 
MCHMCICS5 


MCHMVPT 
MCHMVCC 
MCHMCIC6 
MCHS240 
MCHMFSA 
MCHS252 
MCHMCEL 


Description 


Machine-check interrupt code (from storage locations 232 - 239) as stored 
by hardware routines at time of machine check. 


System damage (SD). 

Processing damage (PD). 

System recovery (SR). 

Timer damage, for S/370 (TD). Unassigned, for 370-XA. 
Clock damage (CD). 

External damage, for 8/370 (ED). 

Reserved. 

Degradation (DG). 


Power warning (W). 

Pending CRW report, for 370-XA. Unassigned, for S/370 (CP). 
Service processor damage. 

Channel subsystem damage, for 370-XA (CK). Unassigned, for S/370. 
Reserved. 

Backed-up indicator (B). 

Delayed, for S/370 (D). Unassigned, for 370-XA. 


Storage error (SE). 

Storage error corrected (SC). 

Key error, for S/370. Storage key error, uncorrected, for 370-XA (KE). 
Double-bit storage error (DS). 

PSW EMWP is valid (WP). 

PSW masks and key are valid (MS). 

Program masks and condition code are valid (PM). 

Instruction address is valid (IA). 


Failing storage address is valid (FA). 
Region code is valid (RC). 

External damage code is valid (EC). 
Floating point register is valid (FP). 
General purpose register is valid (GP). 
Control register is valid (CR). 

Logout (MCEL) is valid (LG). 
Storage logical is valid (ST). 

Reserved. 


Reserved. 

Processor timer is valid. 

Clock comparator is valid. 

Actual length of MCEL data stored for this machine-check interrupt. 

Data from storage locations 240-247. 

Failing storage address from storage location 248. 

Data from storage locations 252-511. 

Model-dependent machine-check extended logout area. Maximum length is 
in MCHCEL field at offset 22 decimal; minimum length is zero. Contains 
model-dependent logout information. Size is machine-dependent. 


Note: No MCEL for 4331, 4341, 3081, or 3090. 


Model Maximum Length 
135 0 bytes 
145 192 bytes 
1S51I/158 672 bytes 
16511/168 1416 bytes 
3031 772 bytes 
3032 1416 bytes 
3033 1224 bytes 
43XX 0 bytes 
308X 0 bytes 
3090 0 bytes 


Damage assessment: model- and SCP-dependent field identifying the extent 
of damage found by a recovery management program. (OS/VS1 only.) 





Machine Check (MCH) Record Format - Non-MVS 


C 


C 


MVS MCH Record Format 


Size (bytes) 
Alignment (bits) 


4(4) 


4(4) 
6(6) 


1(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


24(18) 
28(1C) 


Figure 10-15 (Part 1 of 4). 


Field 
Name 


MCHKEY1 


MCHKEY2 


MCHSMS 


MCHPASS 


MCHSW2 
MCHSYSTR 


MCHSYSTM 


MCHSFTSW 


MCHRCDCT 


MCHDT 
MCHDATE 
MCHTIME 
MCHCPUID 
MCHVER 


MCHSER 
MCHMOD 
MCHCEL 


MCHLNG 
MCHWSC 





MCH Record 


Description 


Class/Source: 

MCH record; type = X’10’. 

MCH Record for MVS; type = X’13’. 

System /release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360. | = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Passed, recovery status. VM passed error to guest. 
Reserved. 

Record-dependent switches: 

System terminated by MCH. 

Reserved. 

System terminated by MCH. 

Record contains an ERRORID. 

Reserved. 

Recovery status bits. See “3090 Processor” on page 20-7. 
Invalid or, for VM, passed to guest. 

Degrade fail. 

Soft fail. 

Hard fail. 

Reserved. 

Reserved. 

Reserved. 

Reserved. 

Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 
Reserved. 

System date and time: 

System date of failure. 

System time of failure. 

CPU identification: 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 


Note: This field is meaningful only for records created in S/370 operating 
mode. 


END OF STANDARD HEADER 


Length of this record, in hexadecimal. 
Wait state code. 


Machine Check (MCH) Record Format - MVS 
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MCH Record 


Offset 
Dec(Hex) 


32(20) 


Size (bytes) 
Alignment (bits) 


32(20) 


33(21) 


34(22) 


36(24) 


37(25) 


39(27) 
40(28) 


Figure 10-15 (Part 2 of 4). 


Field 
Name 


MCHEIA 


MCHTERM 


MCHTSEC 
MCHTCKS 
MCHTWRN 
MCHTDMG 
MCHHARD 
MCHHHRD 


MCHHRPI 
MCHHSTO 
MCHHSPF 
MCHHIPD 
MCHINTM 


MCHITOD 
MCHICKC 
MCHICTM 
MCHIL80 
MCHSOFT 
MCHSSFT 


MCHSEXD 
MCHSECC 
MCHSHIR 
MCHSBUF 
MCHPDAR 
MCHPRTM 


MCHINVP 
MCHRSRC 
MCHRSRF 


MCHRSRS 
MCHRSRI1 


MCHSER 
MCHCHNG 
MCHRSR2 
MCHOFLN 
MCHINTC 


MCHSPER 
MCHNUCL 
MCHFSQA 
MCHLSQA 
MCHPGFX 
MCHVEQR 
MCHPWL 
MCHOPSW 


Description 


MCH error indicator area; flags reflecting the cause and severity of the 
failure. See mapping macro IHALRB, in the MVS or MVS/XA Debugging 
Handbook. 

Terminating error flags: 

Reserved 

Secondary error. 

Check stop. 

Power warning. 

System damage. 

Hard machine error flags: 

Hard error assumed. 

Reserved. 

Register or PSW invalid. 

Hard storage error. 

Hard storage protection key error. 

Instruction processing damage. 

Intermediate error flags: 

Reserved. 

TOD clock error. 

Clock comparator error. 

CPU timer error. 

Interval timer error. 

Soft machine error flags: 

Soft error assumed. 

Reserved. 

External damage. 

ECC-corrected storage error. 

HIR-corrected processor (CPU) error. 

Buffer error. 

PDAR (program damage assessment and repair) data. 
Software status supplied by RTM: 

Reserved. 

Storage reconfigured; page invalidated. 

Storage reconfiguration status available at offset 37. 
Storage reconfiguration not attempted. 

Reserved. 

Storage reconfiguration status: 


Reserved. 
Storage error was already set in frame. 
Frame had change indicator on. 


Frame offline or scheduled to go offline. 

Intercept; frame scheduled to go offline, has a permanent storage error or 
scheduled for V=R status. 

Permanent error occurred in frame. 

Frame contains permanently resident system storage. 

Frame is in use for SQA. 

Frame is in use for LSQA. 

Frame contains page-fixed data. 

Frame is in use for V=R or scheduled for V=R. 

Physical word length (length of checking block used by machine model). 
Machine-check old PSW from storage locations 48-55. 





Machine Check (MCH) Record Format - MVS 
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Offset 
Dec(Hex) 
48(30) 
48(30) 


49(31) 


50(32) 


51(33) 


52(34) 


53(35) 


54(36) 
56(38) 
64(40) 
68(44) 


Figure 10-15 (Part 3 of 4). 


Size (bytes) 
Alignment (bits) 


280 
8 


Byte 0 


yte 4 

Deseo 

XXX = XXKX 

Byte5 

XXXX XX.. 
Ff 

Bytes 6 and 7 

8 

4 

260 


Field 
Name 


MCHMCIC 


MCHMCICO 
MCHMFSD 
MCHMFPD 
MCHMFSR 
MCHMFTD 
MCHMFCD 
MCHMFED 


MCHMFDG 
MCHMCIC1 
MCHMFWN 


MCHMPCRW 
MCHMCHSD 


MCHMIBU 
MCHMIDY 
MCHMCIC2 
MCHMFSE 
MCHMFSC 
MCHMFKE 


MCHMVWP 
MCHMVMS 
MCHMVPM 
MCHMVIA 

MCHMCIC3 
MCHMVFA 
MCHMVRC 
MCHMVDS 

MCHMVFP 

MCHMVGR 
MCHMVCR 
MCHMVLG 
MCHMVST 

MCHMCIC4 
MCHMNVF 


MCHMCIC5 


MCHMVPT 
MCHMVCC 
MCHMCIC6 
MCHS240 
MCHMFSA 
MCHS252 





MCH Record 


Description 


Machine-independent logout. Data from storage locations 232 - 511: 
Machine-check interrupt code (from storage locations 232 - 239) as stored 
by hardware routines at time of machine check: 


System damage (SD). 

Processing damage (PD). 

System recovery (SR). 

Timer damage, for S/370 (TD). Unused, for 370-XA. 
Clock damage (CD). 

External damage, for S/370 (ED). Unused, for 370-XA. 
Reserved. 

Degradation (DG). 


Power warning (W). 

Pending CRW report, for 370-XA (CP). Unused, for S/370. 
Service processor damage. 

Channel subsystem damage, for 370-KA (CK). Unused, for S/370. 
Reserved. 

Backed-up indicator (B). 

Delayed, for S/370. Unused, for 370-XA (D). 


Storage error (SE). 

Storage error corrected (SC). 

Key error, for S/370. Storage key error, uncorrected, for 370-XA (KE). 
Reserved. 

PSW EMWP is valid (WP). 

PSW masks and key are valid (MS). 

Program masks and condition code are valid (PM). 

Instruction address is valid (IA). 


Failing storage address is valid (FA). 
Region code is valid (RC). 

Storage degradation (DS). 

Floating point register is valid (FP). 
General purpose register is valid (GP). 
Control register is valid (CR). 

Logout (MCEL) is valid (LG). 
Storage logical is valid (ST). 


MCH may not be valid. Set if PPAMCHIC and PSAMCHFL = 0. 
Reserved. 


Reserved. 

Processor timer 1s valid. 

Clock comparator is valid. 

Actual length of MCEL data stored for this machine-check interrupt. 
Data from storage locations 240-247. 

Failing storage address from storage location 248. 

Data from storage locations 252-511. 


Machine Check (MCH) Record Format - MVS 
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MCH Record 


Offset Size (bytes) 
Dec(Hex) Alignment (bits) 


328(148) Variable 


Variable 


Field 
Name 


MCHMCEL 


ERRORID 


Description 


Model-dependent machine check extended logout area. Maximum length is 
in MCHCEL field; minimum length is zero. Contains model-dependent 
logout information. Size is machine-dependent. 


Note: No MCEL for 4331, 4341 or 3081. 
Model Maximum Length 


135 0 bytes 
145 192 bytes 
15S5]1/158 672 bytes 
16511/168 1416 bytes 
3031 772 bytes 
3032 1416 bytes 
3033 1224 bytes 
4331 0 bytes 
4341 0 bytes 
3081 0 bytes 


RTM-generated error identifier, consisting of: 


2-byte sequence number 
2-byte CPU identifier 
2-byte ASID 

4-byte time stamp 





If present, the error ID is the last 10 bytes of the record. 


Figure 10-15 (Part 4 of 4). Machine Check (MCH) Record Format - MVS 
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MDR Record 


C Miscellaneous Data (MDR) Record 


MDR records can contain error and usage data from buffered control units or 
communications controllers, or they can document device failures on teleproc- 
essing (TP) devices connected to a communications controller. 

Some of the events that can cause MDR recording are: 

e Overflow of the statistical counters in a buffered control unit 

@ Overflow of the NCP counter in a communications controller 

e TP device failure 


e DASD volume demounts 


e Operator-initiated EOD (End of Day) or ROD (Record on Demand), or 
VARY OFFLINE commands 


e Inan MVS system, some invocations of EREP, which force the writing of 
statistical data to LOGREC. 


Figure 10-16 shows the format of the MDR record. 
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6(6) 


B 


(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


: gone a 


i: 


17(11) 
20(14) 
22(16) 


24(18) 
26(1A) 


Variable 
Variable 2 


Variable 


Field 
Name 


MDRKEY!1 


MDRKEY2 


MDRSMS 


MDRSW2 


MDRDEV 


MDRBUFC 


MDRRCDCT 


MDRCHPID 
MDRDT 
MDRDATE 
MDRTIME 
MDRCPUID 
MDRVER 


MDRSER 
MDRMOD 
MDRCEL 


MDRCUA 
MDRSUBID 


MDRINFO 
MDRRCTWD 





Description 


Class/Source: 


MDR record formatted by SVC 91; type = X’90’. 
MDR record; type = X’91’. 
System/release level: 


OS/360. 


DOS (VSE systems). 


OS/VS1. 


CP67, VM/370, and later VM systems. 
OS/VS2 and later MVS systems. 


Reserved. 


Release level (0-1F). 
Record-independent switches: 
More records follow. 


Last record. 


Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 


ments 8 and 12. 


Record truncated. 
370-XA mode record. 
TIME macro used (MVS). 
Time in timer units (VSE). 


Reserved. 


Record-dependent switches: 


Reserved. 


Record incomplete. 


Reserved. 
Device code: 


See “Device Type Codes in the MDR Record” on page 12-16 for all the 
codes currently supported by EREP. 


Reserved 


Channel set ID, for 8/370. 
Sub-ID field in this record is of variable length. 


Reserved. 


Number of characters (in hexadecimal) in sub-ID field of device identified at 


offset 26. 
Record count: 


Sequence number of this physical record. 

Total number of physical records in this logical record. 
Channel path ID, for 370-XA. 

System date and time of incident: 

System date of failure. 

System time of failure. 

CPU identification: 

Machine version code: 


Reserved. 
Version I CPUs. 


Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 

Maximum length of machine- (CPU-) dependent machine-check extended 


logout area. 


END OF STANDARD HEADER 


Device address of data identified in this record. (Primary CUA, for 8/370. 
Device number, for 370-XA). 

Field (2-15 bytes) that identifies the device whose address is at offset 24. 
The length of this field is at offset 5. 


Note: Depending on the device, this field can be the volume serial number 
(VOLID) or CUA/device number (SCUA) of the unit. 

Device-dependent information supplied by the ERP that detected the error. 
Flag bytes from the record control table (RCT) used to create this record. 
(MVS and MVS/XA only.) 

More device-dependent information. 


Figure 10-16. Miscellaneous Data (MDR) Record Format 
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J 


MIH Record 


C Missing Interrupt Handler (MIH) Record 


MIH records are produced by MVS/370 and MVS/XA for missing channel-end 
(primary status) and/or device-end (secondary status) interrupts on non-TP 
devices. The records use fields from the UCB to define the origin and status of 
the missing interrupt. 


The VSE/Advanced Function system also produces MIH records. See the appro- 
priate licensed program manual for the VSE/Advanced Functions MIH record 
format. 


Figure 10-17 shows the format of the MIH record produced by MVS/370; 


Figure 10-18 on page 10-39 shows the format of the MIH record produced by 
MVS/XA. 
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MIH $ Record 





370-Mode MIH Record Format 


Offset 
Dec(Hex) 


0(0) 
1(1) 


5(5) 
6(6) 


7(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


24(18) 


32(20) 
35(23) 
38(26) 
44(2C) 


48(30) 
56(38) 
56(38) 
80(50) 


Size (bytes) 
Alignment (bits) 


8 
Variable 
24 
Variable 


Field 
Name 


MIHKEY1 
MIHKEY2 


MIHSMS 


MIHSW2 
MIHSW3 
MIHCEBIT 
MIHDEBIT 


MIHCSID 
MIHRCDCT 


MIHDT 
MIHDATE 
MIHTIME 
MIHCPUID 
MIHVER 


MIHSER 
MIHMOD 


MIHJOBID 


MIHCUA2 
MIHCUAI 
MIHVOL 
MIHDEV 


MIHINT 


Description 


Class/Source: 

MIH record, S/370 mode; type = X’70’. 
System/release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 
OS/VS2 and later MVS systems. 
Reserved. 

Release level (0-1F). 
Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Reserved. 

Record-dependent switches: 

Reserved. 


Channel-end interrupt found pending. 
Device-end interrupt found pending. 

Device found idle with request queued. 
Reserved. 

Channel set ID for MVS. 

Record count: 

Sequence number of this physical record. 
Total number of physical records in this logical record. 
Reserved. 

System date and time, as: 

System date of failure. 

System time of failure. 

CPU identification, as: 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Not used. 


END OF STANDARD HEADER 


Alphameric name assigned to job (as identified, for example, by a jobname 
on a JCL JOB statement) with an I/O request pending. If jobname cannot 
be determined, field is set to blanks. 

CUA used to address the device. 

Primary CUA of device. 

VOLSER of volume on device associated with pending I/O request. 
Device class and type (from UCB) of unit associated with pending I/O 
request. 

Time interval (decimal) used by MIH to check for pending conditions. 
System-dependent data. For example, for MVS the fields contain: 

UCB common portion. 

UCB device-dependent data: 


24 bytes for tape and DASD 
16 bytes for graphics devices 
8 bytes for all other devices. 





Figure 10-17. MVS/370 Missing Interrupt Handler (MIH) Record Format 
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C 


3(3) 
5(5) 
6(6) 


1(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


24(18) 
32(20) 
32(20) 
36(24) 
40(28) 
41(29) 
42(2A) 
43(2B) 
44(2C) 
46(2E) 
47(2F) 
48(30) 
56(38) 
60(3C) 
72(48) 
84(54) 


Figure 10-18 (Part 1 of 2). 


Size (bytes) 
Alignment (bits) 


OO me mm FOO me me Re = BA OO 


5 es gO: rr er 


N 


NN 


—2 


x 
ba 


Field 
Name 


MIXKEY1 
MIXKEY2 


MIXSMS 


MIXSW2 
MIXCSID 
MIXRCDCT 


MIXDT 
MIXDATE 
MIXTIME 
MIXCPUID 
MIXVER 


MIXSER 
MIXMOD 


MIXJOBID 
MIXSCHIB 
MIXPMCWO 
MIXPMCW1 
MIXLPM 
MIXPNOM 
MIXLPUM 
MIXPIM 
MIXMBI 
MIXPOM 
MIXPAM 
MIXCHPID 
MIXPMCW6 
MIXSCSW 
MIXMDEP 
MIXINTVL 





MIH Record 


MVS/XA Missing Interrupt Handler (MIX) Record Format 


Description 


Class/Source: 

S/370-XA MIH record; type = X’71’. 

System /release level: 

OS/360. 

DOS (VSE systems). 

OS/VSI1. 

CP67, VM/370, and later VM systems. 
OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Reserved. 

Reserved. 

Channel set ID for MVS. 

Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 
Reserved. 

System date and time, as: 

System date of failure. 

System time of failure. 

CPU identification, as: 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Not used. 


END OF STANDARD HEADER 


Jobname from ASID. 

Subchannel information block: 
Interrupt parameter. 
Path-management control word 1. 
Logical path mask. 
Path-not-operational mask. 
Last-path-used mask. 
Path-installed mask. 
Measurement block index. 
Path-operational mask. 
Path-available mask. 

CHPIDs 0-7. 

Path-management contro! word 6. 
Subchannel status words. 
Model-dependent area. 

Time interval used for detection. 


MVS/XA Missing Interrupt Handler (MIX) Record Format 


Chapter 10. Records for EREP 10-39 





Dec(Hex) 
92(5C) 


93(5D) 


121(79) 
122(7A) 
124(7C) 
126(7E) 
130(82) 
136(88) 


137(89) 
138(8A) 


139(8B) 
140(8C) 
141(8D) 
144(90) 
145(91) 
146(92) 
147(93) 
148(94) 
152(98) 
156(9C) 


CO Be Be ee = = |) =: 


Figure 10-18 (Part 2 of 2). 
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MIXDEFLT 
MIXATMPT 
MIXTRIED 


MIXSID 
MIXPMCW 
MIXULPM 
MIXULPUM 
MIXUPIM 
MIXUCPID 
MIXUCBLV 
MIXIOSFG 
MIXLVMSK 
MIXFLAGS 
MIXFLAG1 


MIXFLAG2 
MIXUCHAN 
MIXFLAG3 
MIXDEVTY 
MIXVOLUM 
MIXFLAG4 


MIXFLAGS 
MIXFLG1 
MIXADDLI 


MIXFLG2 
MIXRSNC 


MIXHLTRC 
MIXCLRRC 
MIXSTRC1 
MIXSTRC2 
MIXCIRBI 
MIXCIRB2 


Description 


Type of missing interrupt (MIH code): 
Missing CSCH interrupt. 

Missing HSCH interrupt. 

Device found idle with request queued. 
Start pending in subchannel. 

Reserved. 

Mount pending in subchannel. 
Missing primary status. 

Missing secondary status. 

Missing interrupt handler actions: 
Default actions to attempt. 

Actions to be attempted. 

Actions actually tried. 

Halt or clear subchannel. 

Simulated interrupt. 

Re-drive device. 

Requeue I/O request. 

Issue message. 

Log the condition. 

Reserved. 

Subchannel ID number. 
Path-management control word from UCBPMCW1l. 
Logical-path mask from UCBLPM. 
Last-Path-Used mask from UCBLPUM. 
UCBPIM. 

CHPIDs from UCBCHPID. 

UCB level byte. 

IOS Flags. 

Level mask from UCBLVMSK. 

MIH flag proc (UCBMIHTI). 


-Flag byte. 


UCBALTCU. 

Reserved. 

Flag byte from UCBFLC. 

Device number from UCBCHAN. 

Flag bytes from UCBSFLS. 

UCB device class/type. 

Volume serial number. 

Flag byte. 

UCBMOUNT. 

Reserved. 

Flag byte from UCBFL4 (DASD only). 

MIH record flags: 

Additional-data flag. 

Reserved. 

Reserved. 

Reason code associated with MIXITYPE (offset 92 decimal). 
Reserved. 

Halt-request return code from IOSVHSCH. 
Clear-request return code from IOSVHSCH. 
Store-subchannel-request retrun code from IOSVHSCH. 
Store-subchannel-request retrun code from IOSVHSCH. 
CSCH IRB word 1. 

STSCH IRB word 1. 

Reserved. 





MVS/XA Missing Interrupt Handler (MIX) Record Format 


C 


OBR Record 


Outboard (OBR) Record 


OBR records document a variety of I/O errors and statistical data. They can take 
one of two forms, depending on why they are written. 


The short form is used to record statistical data for the devices (except tape 
drives) whose statistical data counters are in “core” rather than in control-unit 
buffers (see “Miscellaneous Data (MDR) Record” on page 10-35). It is also 
written in response to the same operator-initiated and program-initiated actions 
that can trigger an MDR record. When statistical data is written to the ERDS 
before EREP begins to retrieve records for a report, the data is in short OBR 
records or MDR records, depending on the devices involved. (For tape devices, 
statistical data is in long OBR records.) 


The long form of the OBR record includes, in addition to the information con- 
tained in the short form, documentation of permanent unit checks (I/O errors that 
the system’s error recovery program could not correct). The long form also docu- 
ments some temporary unit checks and statistical data for devices with in-core 
counters. 


MVS and MVS/XA write a long OBR record when the dynamic pathing avail- 
ability facility encounters an error while changing the state of a path group. 


For teleprocessing (TP) devices and controllers, the device-dependent data in the 
OBR record is detailed in an IBM International Systems Center Bulletin entitled 
Network Error Data. 


Figure 10-19 on page 10-42 shows the format of short OBR records; 
Figure 10-20 on page 10-44 shows the format of long OBR records. 
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OBR Record 


Short OBR Record Format 


6(6) 


1(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


Figure 10-19 (Part 1 of 2). 
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Size (bytes) 
Alignment (bits) 


1 
11 
11 
11 
XX.. 
1 
000. 
001. 
010. 
O11. 
100. 


Field 
Name 


OBRKEY1 


OBRKEY2 


OBRSMS 


OBRSW2 


OBRXASW 


OBRCSID 
OBRRCDCT 


OBRDT 
OBRDATE 
OBRTIME 
OBRCPUID 
OBRVER 


OBRSER 
OBRMOD 
OBRCEL 


Description 


Class/Source: 

OBR (unit check) record; type = X’30’. 

TP access method (TCAM (VS)/BTAM (VSE)) OBR record; type = X’34’. 
TP access method (VTAM) OBR record; type = X’36’. 

Not used for short OBR record. 

System/release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Reserved. 

Record-dependent switches: 


SDR counters dumped at EOD. 


Temporary switch, counter overflow. 
Short OBR record. 

Not used. 

Volume demount. 

Reserved. 


CHPID is invalid. 

Sense unavailable. 

Reserved. 

Model/version number; used with device type to indicate model or version. 
Channel set ID, for S/370. Unused for 370-XA. 
Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 
Reserved. 

System date and time of incident: 

System date of failure. 

System time of failure. 

CPU identification. 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 


END OF STANDARD HEADER 





Outboard (OBR) Record Format (Short Form) 


OBR Record 


Offset Size (bytes) Field 
Dec(Hex) Alignment (bits) Name Description 


24(18) 4 OBRCODE Code for the device class and type of the failing device. First two bytes are 
VSE PUB bytes 4 and 5; second two bytes are MVS UCB device class and 
type bytes 18 and 19 (decimal). See “Device Type Codes in the OBR 
Record” on page 12-13 for all the codes currently supported by EREP. 

28(1C) 1 OBRLSDRC Number of bytes of statistical data recorded in the statistical data area at 


offset 32. 
29(1D) 3 OBRPCUA Primary CUA of the device associated with the failing I/O operation. 
32(20) Variable OBRSDINF Statistical data area, containing statistical counter/indicator data from the 
device statistics table. 
32(20) OBRSRDS SDR counts: 
OBRSDRSI Temporary reads 
OBRSDRS2 Temporary writes 
SRCTWD Flag bytes from the record control table (RCT) used to create this record. 
(MVS and MVS/XA only.) 
OBRSIOCT The number of STARTIOs to the device since the last recording. (VSE 
only.) 





Figure 10-19 (Part 2 of 2). Outboard (OBR) Record Format (Short Form) 
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OBR Record 








Long OBR Record Format 


Offset 
Dec(Hex) 


0(0) 


Size (bytes) 
Alignment (bits) 


1(1) 


2(2) 


3(3) 


6(6) 


1(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


Figure 10-20 (Part 1 of 2). 
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Field 
Name 


OBRKEY1 


OBRKEY2 


OBRSMS 


OBRSW2 


OBRXASW 


OBRCSID 
OBRRCDCT 


OBRDT 
OBRDATE 
OBRTIME 
OBRCPUID 
OBRVER 


OBRSER 
OBRMOD 
OBRCEL 


Description 


Class/Source: 

OBR (unit check) record; type = X’30’. 

TP access method (TCAM (VS)/BTAM (VSE)) OBR record; type = X’34’. 
TP access method (VTAM) OBR record; type = X’36’. 

Dynamic Pathing Availability OBR record; type = X’3A’ 

System /release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Reserved. 

Record-dependent switches: 


Statistical data (SDR) counters dumped at EOD. 
Temporary switch, counter overflow. 


Short OBR record. 

Alternate channel path was retried. 

Not used. 

Volume demount. 

SVC requested (VSE only). 

Field OBRSECUA contains polling characters instead of CUA. (Set for 
BTAM and TCAM OBR records only). 


CHPID is invalid. 

Sense unavailable. 

Reserved. 

Model/version number; used with device type to indicate model or version. 
Channel set ID, for S/370. Unused for 370-XA. 
Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 
Reserved. 

System date and time of incident: 

System date of failure. 

System time of failure. 

CPU identification. 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 


END OF STANDARD HEADER 





Outboard (OBR) Record Format (Long Form) 


Offset 
Dec(Hex) 
24(18) 


32(20) 
40(28) 


48(30) 
49(31) 


56(38) 
57(39) 


603C) 
62(3E) 


64(40) Variable 
Variable Variable 


Variable 
16 


2 


Figure 10-20 (Part 2 of 2). 


Field 
Name 


OBRJOBID 


OBRFCCW 
OBRCSW 


OBRDEVDC 
OBRSECUA 


OBRLSDRC 
OBRPCUA 


OBRRETRY 
OBRSBCNT 
OBRDEVDP 
OBRSDINF 


OBRSENSE 
OBRIRB 


OBRRCTWD 





OBR Record 


Description 


Jobname or userID. 

CCW being executed at time of failure. 

Contents of CSW stored following detection of I/O error. Records indi- 
cating path failures handled by alternate path recovery are identified by the 
unique CSW status of Interface Control Check plus Channel Control 
Check. Bytes 4 and 5 are the “status byte.” Not used for 370-XA. 
Number of doublewords used for device-dependent data. 

For S/370, secondary channel and unit address (actual CUA) associated 
with final retry of failing I/O device; or TP polling characters (BTAM and 
TCAM only), right-justified. 


For 370-XA, byte 0 contains the channel path ID (CHPID), left-justified. 
Bytes 1 and 2 contain the channel-path polling characters: the unmodified 
unit address or device number (NOT the same as the device number that 

replaces the PCUA). 

Device type for the device associated with the error. 


Byte | contains a control unit ID. 

Reserved. 

Control unit ID if Byte 0, Bit 0 is 1’. Otherwise system dependent data 
unused by EREP. 

Device class code. 

Device type code. See “Device Type Codes in the OBR Record” on 

page 12-13 for all the codes currently supported by EREP. 

Number of bytes of data recorded in the statistical data area (OBRSDINF). 
(370-XA only.) 

For 8/370, primary CUA of device being used when failure occurred. For 
IBM 2314, 3330 or 3340 series of devices, this field contains the physical 
location (not address) of the failing unit. For 370-XA, this field contains 
the device number. 

Number of I/O retries attempted for this error incident. 

Number of bytes of sense data in field OBRSENSE. 

Device-dependent data. 

Statistical data area, containing statistical counter/indicator data from 
device statistics table. 

Device-dependent sense information received from the device. 

For 370-XA, information from the subchannel status word (SCSW) (and the 
extended status word (ESW), if available). Not used for S/370. 

Flag bytes from the record control table (RCT) used to create this record. 
(MVS and MVS/XA only.) For VSE records: 


@ The field is 4 bytes. 

@ Itis the SIO field. However, it is not present for some devices — spe- 
cifically, tape and DASD that record the SIO counts either in the 
device dependent data or in MDR records. 


Outboard (OBR) Record Format (Long Form) 
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SFT Record 


Software (SFT) Error Record 
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MVS and MVS/XA produce a software record (type X’4X’) as part of the system 
error recovery process. The record includes such software-specific information as 
the ERRORID and the system diagnostic work area (SDWA) control block and 
its extensions for the failing task or request block. The SDWA is mapped by 
IHASDWA and is fully documented in the Debugging Handbook. It identifies the 
error and includes information used by the recovery routines. 


The MVS systems also write a software record at the request of the machine 
check handler (MCH) to provide program-damage assessment data in case of a 
machine check. They also produce a short form of the software record to indicate 
the number of records lost because the error-recording (LOGREC) buffer was 
full. 


Under VS1, VTAM prepares software records to document program failures. 


VM writes no type X’4X’ record of its own. It reflects back to the guest system 
any SFT records it detects. 


Figure 10-21 shows the format of the software record. 


( Size (bytes) 
, Alignment (bits) 


6(6) 


7(7) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


24(18) 


32(20) Variable 


Variable 10 


Field 
Name 


SFTKEY1 


SFTKEY2 


SFTSMS 


SFTSW2 


SFTRCDCT 


SFTDT 
SFTDATE 
SFTTIME 
SFTCPUID 
SFTVER 


SFTSER 
SFTMOD 


SFTJOBID 


SFTSDWA 


ERRORID 





Figure 10-21. Software Record Format 


C 


SFT Record 


Description 


Class/Source: 

Software-detected software error; type = X’40’. 
Hardware-detected software error; type = X‘42’. 
Operator-detected error; type = X’44’. 
Hardware-detected hardware error; type = X’48’. 
Lost-record summary record; type = X’4F’. 
System/release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Reserved. 

Record-dependent switches: 


Short record. (Set for type X’4F’ records.) 
Record incomplete. (Record truncated because of lack of buffer space.) 
Record contains an ERRORID. 

Not used. 

Reserved. 

Reserved. 

Record count: 

Sequence number of this physical record. 
Total number of physical records in this logical record. 
Reserved. 

System date and time, as: 

System date of failure. 

System time of failure. 

CPU identification. 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Not used. 


END OF STANDARD HEADER 


Alphameric name assigned to job (as identified, for example, by a jobname 
on a JCL JOB statement) being executed and/or requesting service at time 
of failure. In the short software record, this byte contains the count of 
records lost because the LOGREC buffer was full. 

System diagnostic work area, detailed by IHASDWA mapping macro. The 
SDWA is filled in and used by the FRR or ESTAE/ESTAI in recovery 
processing. See your Debugging Handbook for the detailed format. 
RTM-generated error identifier consisting of: 


2-byte sequence number 
2-byte CPU identifier 
2-byte ASID 

4-byte time stamp 


The error ID is always the last 10 bytes of the record. 
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SLH Record 


Subchannel Logout Handler (SLH) Record 
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In S/370-XA, SLH records are produced for subchannel-detected errors that do 
not terminate system operation. The SLH record, combined with the CRW 
record, corresponds to the CCH record written for S/370 channel checks. The 
record contains subchannel-dependent error information reflecting the type 
(storage or key) and location (CCW, IDAW, buffer) of the error, if available from 
the logout information in the extended status word (ESW). 


Figure 10-22 shows the format of the SLH record. 


6(6) 


17) 
8(8) 
8(8) 
12(C) 
16(10) 
16(10) 


17(11) 
20(14) 
22(16) 


Figure 10-22 (Part 1 of 2). 


Size (bytes) 
Alignment (bits) 


. 
. 

— 
iy 


SERRE CE” 


om Om 
aaa 7 be 


: goes qo Dos 


ss: 


Field 
Name 


SLHKEY1 
SLHKEY2 


SLHSMS 


SLHPASS 


SLHSW2 
SLHSW3 
SLHSWS 


SLHSFTSW 


SLHRCDCT 


SLHDT 
SLHDATE 
SLHTIME 
SLHCPUID 
SLHVER 


SLHSER 
SLHMOD 
SLHCEL 





SLH Record 


Description 


Class/Source: 

SLH Record; type = X’23’. 

System/release level: 

OS/360. 

DOS (VSE systems). 

OS/VS1. 

CP67, VM/370, and later VM systems. 

OS/VS2 and later MVS systems. 

Reserved. 

Release level (0-1F). 

Record-independent switches: 

More records follow. 

Last record. 

Time-of-Day clock instruction issued (0 = IBM System/360, 1 = IBM 
System/370). Used in conjunction with date and time values at displace- 
ments 8 and 12. 

Record truncated. 

370-XA mode record. 

TIME macro used (MVS). 

Time in timer units (VSE). 

Passed, recovery status. VM passed error to guest. 
Reserved. 

Record-dependent switches: 

Reserved. 

Reserved. 


Reserved. 

Recovery status bits. See “3090 Processor” on page 20-7. 
Invalid or, for VM, passed to guest. 

Hard fail. 

Degrade fail. 

Soft fail. 

Record count: 

Sequence number of this physical record. 

Total number of physical records in this logical record. 
Reserved. 

System date and time, as: 

System date of failure. 

System time of failure. 

CPU identification. 

Machine version code: 

Reserved. 

Version I CPUs. 

Version II CPUs. 

CPU serial number. 

CPU machine model number (3033, 4341, etc.). 
Maximum length of machine- (CPU-) dependent machine-check extended 
logout area. 


END OF STANDARD HEADER 


Subchannel Logout (SLH) Record Format 
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SLH Record 


49(31) 
50(32) 


51(33) 


64 


52(34) 


116(74) 
120(78) 
122(7A) 
128(80) 
133(85) 
135(87) 
136(88) 
140(8C) 
144(90) 
146(92) 


NONARPREPNUAN 


148(94) 


Figure 10-22 (Part 2 of 2). 
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Field 
Name 


SLHJOBID 
SLHFCCW 
SLHDEVT 


SLHERPIB 


SLHESW01 
SLHRSVD1 
SLHFLG1 
SLHSSCH 
SLHINT 
SLHTSCH 
SLHHSCH 


SLHSENSE 
SLHCSWCT 
SLHRETRY 
SLHLPUM 
SLHVALID 


SLHVLPUM 
SLHVTERM 
SLHVSEQC 
SLHVDVST 
SLHVCCW 
SLHVDVNO 
SLHTRMSQ 
SLHTRMCD 


SLHIOALT 
SLHSEQCD 


SLHIRB 


SLHUCBAD 
SLHDEVNO 
SLHVOLSR 

SLHUCBLV 


SLHCHPID 
SLHSID 
SLHRSMAD 
SLERSMRC 
SLHRSMER 


SLHCKBYT 


SLHRSMST 


Description 


Identity of job executing at time of failure. 

Last CCW executed before failure. 

Code for device class and type of failing device. The first two bytes are not 
used for this record. The second two bytes are the OS/VS UCB device class 
and type bytes 18 and 19 (decimal). See “Device Type Codes in the OBR 
Record” on page 12-13 for a list of the UCB codes. 

ERP information block (Information from the ESW (extended status 
word)). 

Byte 0 of the ESW. 

Reserved. 

Flag byte: (Byte 0 of the ESW, modified) 

No status stored after SSCH. 

Status stored after I/O interrupt. 

No status stored after TSCH. 

No status stored after HSCH. 

Reserved. 

Sense data was stored. 

CSW count is valid. 

Operation cannot be retried. 

Last-path-used mask (LPUM). (Byte 1 of the ESW) 

Validity indicators: (Byte 2 of the ESW, modified.) 

Reserved. 

LPUM consistent with log indicator. 

Termination code valid. 

Sequence code valid. 

Device status valid. 

CCW address valid. 

Device number valid. 

Termination and sequence codes: (Byte 3 of the ESW.) 
Termination code: 

Interface disconnect. 

Stop, stack or normal termination. 

Selective reset. 

Reserved. 

1/O error alert. 

Sequence code: 

Reserved. 

Command sent but status not analyzed. 

Command accepted by device but no data transferred. 

At least one byte of data has been transferred. 

Command not sent or sent but not yet accepted. 

Command accepted but data transfer unpredictable. 
Reserved. 

Reserved. 

IRB; includes the SCSW (subchannel status word), the ESW (extended 
status word), and the ECW (extended control word; model-dependent). See 
your Debugging Handbook for the detailed format of the IRB. 
UCB or RDEV address. 

Device number. 

Volume serial number. 

UCB level byte and mask. 

Reserved. 

Channel path ID. 

Subchannel ID number. 

Absolute address of storage or key error, if available. 

RSM return code for storage or key error. 

Error type: 

Reserved. 

Last two bits indicate storage or key error: 

Reserved. 

Storage error. 

Key error. 

Other. 

RSM status information. 





Subchannel Logout (SLH) Record Format 


Chapter 11. EREP Messages 


This section of the EREP User’s Guide and Reference contains the messages issued 
by the IFCEREP1 program modules. These are the messages that appear as the 
TOURIST! output, either along with the printed report or on the terminal screen. 
Some of the messages listed here also appear in the report output. 


Also included in this chapter are the messages issued by CMS and CPEREP 
during VM EREP processing. These messages can appear on the display terminal 
screen in the course of CPEREP processing, but are not really EREP messages. 
See the Messages and Codes manual for your VM system for general information 
about the messages issued by CMS on behalf of other programs. The 
CMS/CPEREP messages are listed and explained in “CPEREP Messages for VM 
Users” on page 11-48. 


. Introduction to IFC-prefixed Messages 


Although all the IFC-prefixed EREP message numbers are followed by “I,” 
meaning that they are informational, they can in fact indicate both the status of 
EREP processing and the occurrence of a problem with EREP processing or your 
EREP/system controls. When IFCEREP! encounters a severe error, it stops. See 
“EREP Return Codes” on page 11-54 for the return codes issued by IFCEREP1. 


EREP messages are prefixed with “IFC,” the prefix for the program itself 
(IFCEREP1). They are listed here in ascending order of the numbers that follow 
the prefix. Note that not all the messages apply to all three operating systems. 
The explanation for each message indicates which system(s) the message is for. 


In “Problem Determination Aids” on page 11-54 are three tables of recommended 
general problem determination actions. Many message descriptions include refer- 
ences to numbered items in these tables to help you get started on diagnosing a 
problem. 


For VSE systems, the messages and the report output are written to the SYSLST 
logical unit. 
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Message Format 


The following table summarizes the source and format of the IFC-prefixed EREP 
messages as presented in this book: J 


Component prefix: IFC 


Program producing messages: IFCEREP1 


Where produced: TOURIST data set or SYSLST; with report 
output or at terminal. 

Audience: System programmer 

Message format: IFCnnnlI text 


nnn is the message serial number. 
text is the text of the message. 
Following the text of each message are other kinds of information: 


Explanation: Under which system(s) the message appears, and what 
the message means. 


System Action: What happens when the message Is issued. 
Programmer Response: What the system programmer should do when the 
message appears. } 


Problem Determination: Items in the problem determination tables that may 
help document the problem. 
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IFC*** Messages 





C EREP Messages for MVS, VM, and VSE Users 


IFC1011 





REQUEST FOR NON-EXISTENT I/O SERVICE 


Explanation: (MVS, VM, and VSE). An internal request for I/O service specified 
an invalid request code. 


System Action: The request is ignored. No further input is processed. 


Programmer Response: Make sure the system controls are correct, then rerun the 
job. If the problem persists, perform problem determination. 


Problem Determination: Table I, items 2, 4, 29. 


IFC1021 





ddname OPEN REQUESTED, ALREADY OPEN 


Explanation: (MVS and VM). A second open was requested for a data set that is 
already open. 


ws System Action: The request is ignored. No further input is processed. 


Programmer Response: Make sure the DD statements or FILEDEFs are correct, 
then rerun the job. If the problem persists, perform problem determination. 


Problem Determination: Table I, items 2, 4, 29. 


IFC1031 





ddname DD STATEMENT MISSING OR INCORRECTLY CODED 


Explanation: (MVS and VM). The named data set could not be opened because 
the required DD statement or FILEDEF is missing or invalid. For an existing 
data set, the DD statement or FILEDEF may be correct but the attributes 
(RECFM, BLKSIZE) invalid. 


System Action: EREP terminates. 


Programmer Response: Add or correct the indicated system control and rerun the 
job. 


Problem Determination: Table I, items 2, 4, 29. 
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IFC*** Messages 
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IFC104I 





ddname NOT OPEN WHEN {READ|WRITE} REQUESTED 


Explanation: (MVS and VM). The named data set was not open when a read or 
write was requested. 


System Action: The request is ignored. No further input is processed. 
Programmer Response: Make sure the DD statements and FILEDEFS are 
correct, then rerun EREP. If the problem persists, perform problem determi- 


nation. 


Problem Determination: Table I, items 2, 4, 29. 


IFC105] 





RECORD IGNORED; ddname READ ERROR 


Explanation: (MVS and VM). A permanent I/O error has occurred on the named 
data set. 


System Action: Processing continues. The physical record that caused the error is 
ignored. 


Programmer Response: Move the volume containing the data set to another 
device, or move the data set to another volume, to determine if the problem was 
caused by a hardware malfunction. 


Warning: Move the suspect volume only once to ascertain a fault. 
Indiscriminate mounting and demounting of the disk pack could 
cause the destruction of packs and drives. 


For MVS systems: If the message does not recur, there probably is a hardware 
error on the device (or volume) originally used. If the error persists, execute the 
SPZAP (VS2), or HMASPZAP (VS1) service aid program to obtain a dump of 
the data set on which the input error occurred. If the error occurred on 
SYS1.LOGREC, execute IFCDIP00 to reinitialize the data set. 


For VM systems: If the error occurred in the error-recording area, issue the 
CPEREP command, with the CLEAR/CLEARF operand, to reinitialize the cylin- 


ders. 


Problem Determination: Table I, items 2, 4, 29, or 30. 


IFC*** Messages 


IFC106I 





ddname CLOSE REQUESTED, ddname NOT OPEN 


Explanation: (MVS and VM). The ddname data set was not open when a close 
was requested. 


System Action: The request is ignored. 


Programmer Response: Make sure the system controls are correct, then rerun the 
job. If the problem persists, perform problem determination. 


Problem Determination: Table I, items 2, 4, 29. 


IFC1071 





ACCIN RECORD FORMAT NOT V OR VB 


Explanation: (MVS and VM). The ACCIN DD statement or FILEDEF that 
defines the history input data set either: 


@ does not specify RECFM, or 
@ does not specify the RECFM as V or VB, or 
@ specifies a volume or CMS file that does not contain variable format records. 


System Action: The job step terminates. 


Programmer Response: Verify that the record format of the data set is V or VB 
and is properly specified on the DD statement or FILEDEF. 


IFC108] 





ATTEMPTED TO READ OUTSIDE SERLOG EXTENT 


Explanation: (MVS). IOS indicates an attempt was made to read outside the 
extent on SERLOG (SYS1.LOGREC). The LOGREC header may be bad. 


System Action: EREP continues processing. The record that caused the input 
error is ignored. SYS1.LOGREC is not cleared. 


Programmer Response: Execute the SPZAP (VS2), or HMASPZAP (VS1) service 
aid program to obtain a dump of the data set on which the input error occurred. 
Determine if the problem was caused by a hardware malfunction. If the message 
does not recur, there probably is a hardware error on the device (or volume). 
Otherwise, it is probably a programming error. Execute the IFCDIPOO program 
to reinitialize SYS1.LOGREC. 
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IFC1091 





SERLOG HEADER CANNOT BE READ 


Explanation: (MVS). The header record on the SYS1.LOGREC data set could 
not be read. 


System Action: The job step terminates. 
Programmer Response: Execute the SPZAP (VS2), or HMASPZAP (VS1) service 


aid program to obtain a dump of the SYS1.LOGREC data set. Then execute the 
IFCDIPO00 program to reinitialize the SYS1.LOGREC data set. 


IFC1101 





SERLOG HEADER CHECK BYTE INCORRECT 


Explanation: (MVS). A validity check of the header record on SYS1.LOGREC 
has uncovered an error. 


System Action: EREP terminates. 

Programmer Response: Execute the SPZAP (VS2), or HMASPZAP (VS1) service 
aid program to obtain a dump of the SYS1.LOGREC data set to verify the 
output from the EREP program. Then execute the IFCDIP0O program to reini- 
tialize the SYS1.LOGREC data set. 


Problem Determination: Table I, items 2, 4, 29. 


IFC1111 





OPEN REQUESTED, DATA SET NOT SPECIFIED 


Explanation: (MVS, VM and VSE). An OPEN was requested but the data set to 
be opened was not indicated. 


System Action: EREP terminates. 


Programmer Response: Make sure the DD statements or FILEDEFS are correct, 
then rerun the job. If the problem persists, perform problem determination. 


Problem Determination: Table I, items 2, 4, 29. 





IFC*** Messages 


IFC1121 





READ REQUESTED, NO DATA SET OPEN 


Explanation: (MVS, VM, and VSE). EREP cannot perform the requested read 
operation because no data set is open. 


System Action: EREP terminates. 


Programmer Response: Make sure the DD statements or FILEDEFS are correct, 
then rerun the job. If the problem persists, perform problem determination. 


Problem Determination: Table I, items 2, 4, 29. 


IFC1131 





RECORDS IGNORED, INSUFFICIENT SPACE ON DIRECTWK 


Explanation: (MVS and VM). Not enough space was allocated to the 
DIRECTWK data set to allow EREP to process all the input records. Message 
IFC114I should follow this message. 


System Action: Processing continues. Output will be based on the input read 
prior to the record that could not be written on DIRECTWK;; no further input 
was processed. 


Programmer Response: 
For MVS: Increase the space allocation for DIRECTWK and rerun the job. 


For VM: Erase unnecessary files on the disk; or access a larger disk, possibly a 


temporary disk. (See the CP DEFINE command and the CMS FORMAT 
command.) Then rerun CPEREP. 


IFC114I 





LAST RECORD PROCESSED WAS text data... 


Explanation: This message follows IFC113I and provides a hexadecimal dump of 
the first 40 bytes of the last record processed before the space on DIRECTWK 
was exhausted. 


System Action: None. 


Programmer Response: None. 
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IFC116I 





SYS1.LOGREC HEADER CANNOT BE RESET. USE IFCDIP00 


Explanation: (MVS). The header record of the SYS1.LOGREC data set cannot 
be reset because of an uncorrectable output error. 


System Action: The program terminates normally. 


Programmer Response: Execute the IFCDIP00 program to reinitialize the 
SYS1.LOGREC data set. 


Problem Determination: Table I, items 2, 4, 30. 


IFC1171 





SERLOG CLOSED PREMATURELY. USE IFCDIP00 


Explanation: (MVS and VM). When ERFP tried to check the ERDS header for 
records written while processing, it found that the data set was already closed. 


System Action: The request is ignored; the ERDS is not cleared. 
Programmer Response: If you got all the report output you expected, run 
IFCDIPO0O or CPEREP with CLEAR/CLEARF to reinitialize LOGREC. 
Records written on SYS1.LOGREC during processing will be lost. 


Problem Determination: Table I, items 2, 4, 29. 


IFC118] 





GETMAIN FAILURE WHILE CLEARING SYS1.LOGREC 


Explanation: (MVS). While EREP was clearing LOGREC, it tried to obtain 
storage for the records written to LOGREC during EREP’s previous processing, 
but the GETMAIN failed. 


System Action: Processing continues. However, those records for which EREP 
could not obtain storage are lost. 


Programmer Response: The next time EREP is executed, increase the region size. 
Investigate the possibility that a large number of error records were written on 
SYS1.LOGREC during EREP processing. 


IFC*** Messages 


IFC119] 





RECORDS IGNORED, TABSIZE ALLOCATION TOO SMALL 


Explanation: (MVS, VM, and VSE). EREP’s internal sort table, controlled by 
the TABSIZE parameter, is too small for this report. 


System Action: Processing continues. 


Programmer Response: Increase the value of the TABSIZE parameter, increase 
the region, virtual machine storage or partition size if necessary, and rerun the job 
step. If running IFCOFFLD, you need only increase the region, virtual machine 
storage or partition size. 


IFC1201 





nnnnnn RECORDS THAT PASSED FILTERING SAVED FOR rrrrrrrr 


Explanation: (MVS, VM, and VSE). Indicates the number of records that EREP 
selected and used to generate the requested report; rrrrrrrr is one of the following: 


SYSEXN 

SYSUM PART 1 
SYSUM PART 2 
TREND PART 1 
TREND PART 2 


System Action: None. 


Programmer Response: None. 


IFC1211 





GETMAIN FAILED FOR ?ttttttt TABLE 


Explanation: (MVS and VM). EREP issued a GETMAIN for the amount of 
storage indicated by the TABSIZE parameter, but not enough storage was avail- 
able; rttttttt is one of the following: 


DASDID 
LIMIT 
SHARE 
SORT 
SUMM 


System Action: EREP terminates. 
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Programmer Response: 
For MVS: Increase the region size on the JOB and/or EXEC statement, and rerun 
the job. 


For VM: Rerun CPEREP in a virtual machine having a larger virtual storage 


capacity; or, if the TABSIZE value was larger than necessary, rerun with a 
smaller value for the TABSIZE parameter. 


IFC1221 





nnnnnn RECORDS IGNORED BECAUSE TRUNCATED BIT ON 


Explanation: (MVS, VM, and VSE). Indicates the number of records EREP 
found that had the truncated bit set on. 


System Action: The records are ignored; when you code the TYPE parameter, 
EREP does not process truncated or unknown records. 


Programmer Response: None. 


IFC1231 





nnnnnn RECORDS IGNORED BECAUSE OF UNKNOWN TYPE 


Explanation: (MVS and VM). Indicates the number of records EREP found that 
were from an unsupported source. 


System Action: The records are ignored; when you code the TYPE parameter, 
EREP does not process truncated or unknown records. 


Programmer Response: 

For MVS: Execute the SPZAP (VS2), or HMASPZAP (VSI) service aid program 
to obtain a dump of the output data set to verify the existence of the records of 
unknown type. 


For VM: Try to determine which device triggered the error records. 


IFC1291 





nnnnnnnnn RCDS IGNORED BECAUSE DIRECTWK READ ERRORS 


Explanation: (MVS and VM). Indicates the number of records EREP could not 
process because of I/O errors in reading the DIRECTWK data set. 


System Action: Processing continues. 
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Programmer Response: Rerun the job. If the problem persists, check the DASD 
device or CMS disk on which the DIRECTWK data set resides. 


Problem Determination: Table I, items 2, 4, 30. 


IFC130] 





UNABLE TO FIND MODULE SPECIFIED BY USERPGM 


Explanation: (MVS). EREP was unable to find the program requested via the 
USERPRG parameter. 


System Action: EREP terminates. 


Programmer Response: Verify that the user program requested was correct, and 
that the program is in SYS1.LINKLIB. 


IFC131] 





SYNTAX ERROR AT * 


Explanation: (MVS and VM). The EREP controls that appear above this 
message contain a syntax error. The error is in the keyword or operand above the 
asterisk. This message also appears when EREP encounters a device type on the 
DEV parameter that it does not recognize. 


System Action: EREP terminates. 


Programmer Response: Correct the parameter and rerun the job. 


IFC132I 





DUPLICATION AT * 


Explanation: (MVS and VM). The EREP controls that appear above this 
message contain a duplicate keyword or operand. The duplicate is above the 
asterisk. 


System Action: EREP terminates. 


Programmer Response: Eliminate the duplicate keyword or operand, and rerun 
the job. 
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IFC1331 





PARAMETER CONFLICTS - parameter text 


Explanation: (MVS and VM). The EREP controls that appear above this 
message contain parameters, either specified or implied, that are mutually exclu- 
sive. 


System Action: EREP terminates. 


Programmer Response: Eliminate the conflicting parameters and rerun the job. 


IFC134] 





MORE THAN {10/16} CPUs 
{SPECIFIED WITH SHARE CARDS|ENCOUNTERED} 


nnnn RECORDS DROPPED 


Explanation: (MVS, VM, and VSE). 


e EREP found SHARE statements specifying more than 16 processors (CPUs), 
or 

@ the data set(s) being processed contained records from more than the indi- 
cated number of CPUs, and the EREP controls did not include the CPU or 
MOD selection parameter. 


The System Summary report is limited to 10 processors; all other reports can 
show up to 16. 


System Action: If it is a case of SHARE statements specifying more than 16 
processors altogether, EREP terminates. Otherwise, processing continues, but the 


output does not show all possible processors, only the first 10 or 16. 


Programmer Response: Use the CPU or MOD selection parameter to restrict the 
number of processors whose records are to be processed, and rerun the job. 


IFC135] 





PROCESSING TERMINATED, ddname {READ|WRITE} ERROR 


Explanation: (MVS and VM). A permanent I/O error has occurred on the 
ddname data set. 


VM note: If ddname is ACCDEYV, the following may have occurred: the user did 
not want the records accumulated, but failed to code ACC=N, So the 
default of ACC=Y is in effect. If tape 181 is not attached to the 
virtual machine, this I/O error results. 
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System Action: EREP terminates; the records are not accumulated. 


Programmer Response: 

For VM: If the situation described in the note applies, rerun the job with 
ACC=N. Otherwise, move the volume containing the data set to another 
volume, to determine if the problem was caused by a hardware malfunction. 


For MVS: Move the volume or data set to determine if the problem was caused 
by a hardware malfunction. If the message recurs, execute the SPZAP (VS2), or 
HMASPZAP (VS1) service aid program to obtain a dump of the data set on 
which the input error occurred. If the error occurred on SYS1.LOGREC, run the 
IFCDIP00 program to reinitialize the data set. 


Problem Determination: Table I, items 2, 4, 29, 30. 


Warning: Move the suspect volume only once to ascertain a fault. 
Indiscriminate mounting and demounting of the disk pack could 
cause the destruction of packs and drives. 


IFC136I 





CLOSE REQUESTED, NO DATA SET OPEN 


Explanation: (MVS, VM, and VSE). EREP received a request for the CLOSE of 
a data set, but no data set is open. 


System Action: EREP terminates. 


Programmer Response: Make sure the system controls are correct, then rerun the 
job. If the problem persists, perform problem determination. 


Problem Determination: Table I, items 2, 4, 29. 


IFC137I 





RECORD WITHOUT CPU SERIAL NUMBER ENCOUNTERED 


Explanation: (MVS, VM, and VSE). EREP encountered a record with a 
processor serial number of 000000. 


System Action: The record is ignored. 


Programmer Response: None. 
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IFC138] 





FRAME LOST WHILE WRITING TO ACCDEV 


Explanation: (MVS and VM). EREP encountered an error when writing a frame 
record to the ACCDEV data set. 


System Action: EREP terminates. 


Programmer Response: Rerun the job. If the problem persists, check the device 
on which the data set resides. 


IFC139] 





{MCF | CCF} FRAME xx MISSING — MOD pyyy SER 2zzzzz 


Explanation: (MVS and VM). EREP could not find the expected frame record. 


System Action: Processing continues. However, part of the data record will not 
be edited. Additional messages may appear in the report output. 


Programmer Response: Reinitialize the ERDS for the processor with the indicated 
serial number, using IFCDIP00 with PARM =’FRAMES’ or CPEREP with 
CLEARF. Then rerun the job on that CPU with the MERGE parameter 
included in the EREP controls. 


Problem Determination: Save all associated output for analysis. 


IFC1401 





FRAME CPU-SERIAL-NUMBER TABLE OVERFLOWED 


Explanation: (MVS, VM, and VSE). EREP has encountered more processors 
than the frame table can hold (16). 


System Action: Processing continues, but some CCH or MCH records may not be 
edited with frames. 


Programmer Response: Rerun the job and restrict the number of processors by 
using the CPU selection parameter. 
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IFC1411 





CORE NOT AVAILABLE FOR FRAME PROCESSING 


Explanation: (MVS, VM, and VSE). A GETMAIN or GETVIS for additional 
storage failed. 


System Action: EREP terminates. 


Programmer Response: Increase the amount of virtual storage available to EREP 
and rerun the job. 


IFC142I 





nnnnnn RECORDS FOUND WITH INVALID DATE FIELD 


Explanation: (MVS, VM, and VSE). EREP has encountered one or more records 
with an invalid date field. The last half byte was not an X’F’. 


System Action: The record is ignored and processing continues. 


Programmer Response: None. 


IFC143] 





NUMBER OF xxx TYPE RECORDS READ WAS nannnn 


Explanation: (MVS, VM, and VSE). Indicates the number of records of each 
type that EREP has processed for a Detail Edit or Summary (PRINT) report. 


System Action: None. 


Programmer Response: None. 


IFC144] 





SCAN ERROR CODE AT *** 


Explanation: (MVS and VM). A scan command in a frame record was found for 
which there is no defined action. 


System Action: Processing continues; the frame is dumped in hexadecimal format 
to the EREPPT data set. “***’ is placed in the normal print line in the position 
corresponding to the location in the frame where the error occurred. 
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Programmer Response: Reinitialize the ERDS, using IFCDIP00 with 
PARM =’FRAMES’ or CPEREP with CLEARF, then rerun the job using the 
MERGE parameter. 


Problem Determination: Save all the associated output for analysis. 


IFC145] 





FRAME SET MISSING pyyy zzzzzz 


Explanation: (MVS and VM). EREP has identified a missing frame set for 
processor model yyyy and serial zzzzzz. 


System Action: MCH and CCH records for processor model yyyy, serial zzzzzz 
will not be edited correctly because the frame set needed to edit them is missing. 


Programmer Response: If the ERDS was the input data set, you may need to rein- 


itialize it CGFCDIP00 with PARM =’FRAMES’ or CPEREP with CLEARF) to 
make sure all the frames are there. 


IFC1461 





NO FRAMES AVAILABLE {MCH/|CCH} MOD pyyy SER 22zzzz 


Explanation: (MVS and VM). No frames are available for processing the MCH 
or CCH error record with this model and serial number. 


System Action: Processing continues. The error record is not edited, or is edited 
with frames for the same model number only. 


Programmer Response: Reinitialize the ERDS using IFCDIP00 with 


PARM =’FRAMES’ or CPEREP with CLEARF, then rerun the job using the 
MERGE parameter. 


IFC147] 





LOG ERR {MCF|CCF} FRAME xx MOD yyyy SER 2zzzzz. 


Explanation: (MVS and VM). EREP detected an invalid log type scan code in 
the frame. 


System Action: Processing continues. This frame is not used; part of the error 
record is not summarized. 


Programmer Response: Reinitialize the ERDS using IFCDIP00 with 
PARM =’FRAMES’ or CPEREP with CLEARF, then rerun the job using the 
MERGE parameter. 
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IFC148I 





xxx RECORDS REQUESTED BUT NOT FOUND 


Explanation: (MVS, VM, and VSE). You requested Detail Edit or Summaries for 
record type xxx. Either EREP did not find any records of that type on the input 
data set, or none of the records passed filtering. (By date, for example.) 


System Action: Processing continues. 


Programmer Response: If you want to see records of this type, modify the 
selection parameters in the EREP controls for this report. 


IFC149I 





nnnnnn DIRECTWK READ FAILURES 


Explanation: (MVS and VM). Indicates the number of records that were lost 
while reading from the DIRECTWK data set. 


System Action: Processing continues. 


Programmer Response: Rerun the job. If the problem persists, check the direct 
access device on which the data set resides. 


Problem Determination: Save the console spool file. Contact IBM for hardware 
support. 


IFC1501 





nnnnnn RECORDS READ FROM INPUT SOURCE 


Explanation: (MVS, VM, and VSE). Indicates the number of records EREP read 
for the report. 


System Action: None. 
Programmer Response: None. 


Problem Determination: None. 
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IFC152I 





nnnnnn RECORDS FOUND WITH A ZERO VOLID 


Explanation: (MVS, VM, and VSE). Indicates the number of records EREP 
found that contained a volume serial of 000000. 


System Action: None. 
Programmer Response: None. 


Problem Determination: None. 


IFC1531 





GETMAIN FAILED FOR MODULE mmmmmmmm 


Explanation: (MVS and VM). The region or storage size is too small to contain 
the tables for this module. 


System Action: EREP terminates. 


Programmer Response: Increase the region size or the virtual machine storage size 
and rerun the job. 


IFC154I 





SORTBREAK FORCED DUE TO EXCESSIVE FAULT CODES 


Explanation: (MVS, VM, and VSE). EREP has encountered more different fault 
symptom codes than the symptom code table can hold. 


System Action: The DASD device summary for this channel/control unit will be 
two (or more) reports rather than one. 


Programmer Response: Increase the region/partition or virtual machine storage 
size. If the problem continues, limit the amount of data by use of selection 
parameters. 
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IFC1651 





SORTBREAK FORCED DUE TO EXCESSIVE VOLIDS 


Explanation: (MVS, VM, and VSE). EREP has encountered more unique volume 
identifiers than the VOLID table can hold. 


System Action: The DASD Detail Summary for this channel/control unit will be 
two (or more) reports rather than one. 


Programmer Response: Increase the region/partition or virtual machine storage 


size. If the problem persists, restrict the amount of data by use of selection 
parameters. 


IFC166I 





tttttttt TABLE FULL; INCREASE TABSIZE 


Explanation: (MVS, VM, and VSE). The area allocated to the specified table has 
been filled; rrtttttt is one of the following: 


DASDID 
LIMIT 

SHARE 
CONTROLLER 
SUMM 


System Action: EREP terminates. 


Programmer Response: Increase the TABSIZE value and, if necessary, the 
region/partition or virtual machine storage size as well. Then rerun the job. 


IFC1671 





CUA RANGE IS INVALID ON A SHARE/CONTROLLER CARD 


Explanation: (MVS, VM, and VSE). The range specified on the SHARE or 
CONTROLLER statement either exceeds the 32-address limit, or crosses an 
invalid control unit boundary. For example, the range on 

SHARE=(.. . 130-14F) crosses from an odd to an even CUA and is invalid. 


System Action: EREP terminates. 


Programmer Response: Correct the SHARE/CONTROLLER statement and rerun 
the job. 
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TFC168] 





CUA OVERLAPS WITH ANOTHER SHARE/CONTROLLER ENTRY 


Explanation: (MVS, VM, and VSE). The address range on one SHARE or CON- 
TROLLER statement overlaps the range on another SHARE or CONTROLLER 
statement. 


System Action: EREP terminates. 


Programmer Response: Correct the SHARE or CONTROLLER statement(s) and 
rerun the job. 


IFC169I 





nnnn RECORDS NOT USED BY module name FOR CUX xxx 


Explanation: (MVS, VM, and VSE). Indicates why the number of records used 
to build the maintenance device code does not equal the number of records 
present for this channel/control unit: all MDR and OBR records are passed to 
EREP, but only OBR records with particular fault symptom codes are used for 
the Data Reduction report. 


System Action: Processing continues. 
Programmer Response: None. 


Problem Determination: None. 


IFC1701 





GETVCE FAILURE. LOGICAL UNIT SYSxxx 


Explanation: (VSE). The get-device-characteristics SVC has failed. The device 
type needed to open SYSxxx cannot be obtained. 


System Action: The job step terminates. 


Programmer Response: Correct or add the // ASSGN statement for the appro- 
priate logical unit. 
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IFC1711 





INVALID DEVICE TYPE SYSxxx 


Explanation: (VSE). The device assigned to logical unit SYSxxx is invalid for the 
type of processing that must be performed. 


System Action: The job step terminates. 


Programmer Response: Correct the // ASSGN statement for SYSxxx. 


IFC172] 





SEGMENTED RECORD INCOMPLETE (24-byte header) 


Explanation: (VSE). A segment of a logical record on SYSREC is missing or 
incorrect. The first 24 bytes of the record are included in the message. 


System Action: Not all of the record’s segments are processed. If the segment 
involved belongs to a frame or to SYSREC, the entire frame set is deleted, so 
some MCH and CCH records might not be processed. 


Programmer Response: Check for a succeeding read error message. You may 


have to reallocate and reinitialize IISYSRC. An error-recording transient may be 
executing incorrectly. Call IBM programming support. 


IFC1731 





ERROR READING SYSREC, RECORD SKIPPED 


Explanation: (VSE). A read error occurred on SYSREC. 


System Action: Processing continues. 


Programmer Response: Reallocate IJSYSRC and reinitialize SYSREC using the 
SET RF=CREATE IPL command. 


IFC174] 





nunn RECORDS WITH SENSE BYTES 3 & 4 EQUAL TO SENSE 


BYTES 8&9 


Explanation: (MVS, VM, and VSE). OBR records with fault symptom code 
191A should not have sense bytes 3 and 4 equal to sense bytes 8 and 9. This 
message indicates the number that do, nevertheless. 
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System Action: Processing continues. However, these records are not used to 
determine the maintenance device code. 


Programmer Response: A hardware problem; notify your CE or other mainte- 
nance person. 


Problem Determination: Table III, item 30. 


IFC1751 





logical unit OPEN REQUESTED, ALREADY OPEN 


Explanation: (VSE). A second open was requested for a data set that is already 
open. 


System Action: The request is ignored. No further input 1s processed. 


Programmer Response: Make sure the system controls are correct, then rerun the 
job. If the problem persists, perform problem determination. 


Problem Determination: Table III, items 2, 4, 29. 


IFC176I 





logical unit FAILED TO OPEN 


Explanation: (VSE). The specified data set could not be opened. 


System Action: The job step terminates. 


Programmer Response: Add or correct the // ASSGN statement for the specified 
data set and rerun the job. 


IFC177I 





logical unit NOT OPEN WHEN {READ|WRITE} REQUESTED 


Explanation: (VSE). The specified data set was not open when a read or write 
was requested. 


System Action: The request is ignored. No further input is processed. 


Programmer Response: Make sure the system controls are correct, then rerun the 
job. If the problem persists, perform problem determination. 


Problem Determination: Table III, 2, 4, 29. 
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IFC178I 





RECORDS IGNORED; logical unit READ DIRECT ERROR 


Explanation: (VSE). A permanent I/O error has occurred on the specified data 
set. EREP has ignored one or more records. 


System Action: Processing continues. The physical record that caused the error is 
ignored. 


Programmer Response: Move the volume containing the data set to another 
device, or move the data set to another volume, to determine if the problem was 
caused by a hardware malfunction. If the message does not recur, there probably 
is a hardware error on the device (or volume) originally used. If the error per- 
sists, execute a utility to obtain a dump of the data set on which the error 
occurred. If the error occurred on SYSREC, re-IPL and SET RF=CREATE to 
reinitialize the data set. 


Warning: Move the suspect volume only once to ascertain a fault. 
Indiscriminate mounting and demounting of the disk pack could 
cause the destruction of packs and drives. 


Problem Determination: Table III, items 2, 4, 29, 30. 


IFC1791 





logical unit CLOSE REQUESTED, logical unit NOT OPEN 


Explanation: (VSE). The specified data set was not open when a close was 
requested. 


System Action: The request is ignored. 


Programmer Response: Make sure the system controls are correct, then rerun the 
job. If the problem persists, perform problem determination. 


Problem Determination: Table III, items 2, 4, 29. 


IFC1801 





SYSREC HEADER CANNOT BE READ 


Explanation: (VSE). EREP could not read the header record on SYSREC. 


System Action: The job step terminates. 
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Programmer Response: Execute a utility to obtain a dump of SYSREC. Then 
re-IPL and SET RF =CREATE to reinitialize the recorder file (SYSREC). 


IFC181I 





SYSREC HEADER CHECK BYTE INCORRECT 


Explanation: (VSE). A validity check of the header record on SYSREC has 
uncovered an error. 


System Action: The EREP program terminates. 


Programmer Response: Execute a utility to obtain a dump of SYSREC. Then 
re-IPL and SET RF =CREATE to reinitialize the recorder file (SYSREC). 


Problem Determination: Table III, items 2, 4, 29. 


IFC182I1 





RECORDS IGNORED; INSUFFICIENT SPACE ON SYS001 


Explanation: (VSE). Not enough space was allocated on SYSO01 to process all 
input records. Message IFC183I should follow this message. 


System Action: Processing continues. The report output includes only the records 
read prior to the record that could not be written on SYS001. EREP reads no 
more records for the report. 


Programmer Response: Increase the space allocation for SYSO01 and rerun the 
job. 


IFC1831 





LAST RECORD PROCESSED WAS text data ... 


Explanation: (VSE). This message follows IFC1821 and provides a hexadecimal 
dump of the first 40 bytes of the last record processed before the space on SYSO01 
was exhausted. 


System Action: None. 


Programmer Response: None. 


11-24 EREP User’s Guide 


J 


IFC*** Messages 


IFC184] 





RECORDER FILE HEADER CANNOT BE RESET. RE-IPL AND SET 


RF = CREATE 


Explanation: (VSE). The header record of SYSREC cannot be reset because of 
an uncorrectable output error. 


System Action: The program terminates normally. 


Programmer Response: Re-IPL and issue SET RF =CREATE to reinitialize 
SYSREC. 


Problem Determination: Table III, items 2, 4, 30. 


IFC185I 





GETVIS FAILED FOR tttttttt TABLE 


Explanation: (VSE). A GETVIS was issued for the value indicated by parameter 
TABSIZE and the partition GETVIS area was too small; tttttttt is one of the fol- 
lowing: 


DASDID 

LIMIT 

SHARE 

SORT 

SUMM 

ALIAS LIST 

CI BUFFER 
HEADER BUFFER 


System Action: The job step terminates. 


Programmer Response: Alter the SIZE parameter on the // EXEC statement to 
increase the partition size, then rerun the job. 


IFC186I 





nnnnnn RECORDS IGNORED BECAUSE OF UNKNOWN TYPE 


Explanation: (VSE). EREP has encountered records from an unsupported device. 


System Action: The records are ignored; not used for the report. 


Programmer Response: Execute a utility to obtain a dump of the output data set 
to verify the existence of the unknown records. 
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IFC187I 





nnnnnn RCDS IGNORED BECAUSE SYS001 READ ERRORS 


Explanation: (VSE). The message indicates the number of records EREP could 
not process because of I/O errors in reading the SYS001 data set. 


System Action: Processing continues. 


Programmer Response: Rerun the job. If the problem persists, check the direct 
access device on which the data set resides. 


Problem Determination: Table III, items 2, 4, 30. 


IFC188I 





UNABLE TO FIND MODULE SPECIFIED BY USERPGM 


Explanation: (VSE). EREP was unable to find the program requested via the 
USERPGM parameter. 


System Action: EREP terminates. 


Programmer Response: Verify that the user program requested was correct and 
that the program is on the core image library. 


IFC189I 





SYNTAX ERROR AT * 


Explanation: (VSE). The EREP controls that appear above this message contain 
a syntax error. The error is in the keyword or operand above the asterisk. This 
message also appears when the DEV parameter includes a device type EREP does 
not recognize. 


System Action: The job step terminates. 


Programmer Response: Correct the parameter and rerun the job step. 
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IFC1901 





DUPLICATION AT * 


Explanation: (VSE). The EREP controls that appear above this message contain 
a duplicate keyword or operand. The duplicate is above the asterisk. 


System Action: The job step terminates. 


Programmer Response: Eliminate one of the duplicates and rerun the job step. 


IFC191] 





PARAMETER CONFLICTS - parameter text 


Explanation: (VSE). The EREP controls include parameters that are mutually 
exclusive. 


System Action: The job step terminates. 


Programmer Response: Eliminate the conflicting parameters and rerun the job 
step. 


IFC192] 





PROCESSING TERMINATED; Jogical unit {READ|WRITE} ERROR 


Explanation: (VSE). A permanent I/O error has occurred on the specified data 
set. 


System Action: The job step terminates; SYSREC is not cleared. 


Programmer Response: Move the volume containing the data set to another 
device, or move the data set to another volume, to determine if the problem was 
caused by a hardware malfunction. If the message does not recur, there is prob- 
ably a hardware error on the device (or volume) originally used. If the error per- 
sists, execute a utility to obtain a dump of the data set on which the input error 
occurred. If the error occurred on SYSREC, re-IPL and issue SET 

RF =CREATE to reinitialize the data set. 


Warning: Move the suspect volume only once to ascertain a fault. 
Indiscriminate mounting and demounting of the disk pack could 
cause the destruction of packs and drives. 


Problem Determination: Table III, items 2, 4, 29, 30. 
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IFC193I1 





FRAME LOST WHILE WRITING TO SYS009 


Explanation: (VSE). EREP encountered an error when writing a frame record to 
the SYS009 data set. 


System Action: The job step terminates. 


Programmer Response: Rerun the job. If the problem persists, check the device 
on which the data set resides. 


IFC194] 





{MCF|CCF} FRAME xx MISSING FOR MOD pyyy SERIAL 22zzzzz 


Explanation: (VSE). EREP did not find the expected frame record. 


System Action: Processing continues; part of the data record is not be edited. 
Additional messages may appear in the report output. 


Programmer Response: Reinitialize the recorder file (SYSREC) of the processor 
with the serial number in the message. Then rerun the job on that CPU with the 
EREP parameter MERGE included. 


Problem Determination: Table III, item 13. 


IFC195I 





SCAN ERROR CODE AT *** 


Explanation: (VSE). A scan command in a frame record was found for which no 
action is defined. 


System Action: Processing continues and the frame is dumped in hexadecimal 
format to SYSLST. ‘***’ appears in the normal print line in the position corre- 
sponding to the location in the frame where the error occurred. 


Programmer Response: Reinitialize SYSREC, then rerun the job step using the 
MERGE parameter. probd.Table III, item 13. 
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IFC196I 





FRAME SET MISSING yyyy z2zz2zzz 


Explanation: (VSE). EREP has identified a missing frame for processor model 
yyyy and serial 22zzzzz. 


System Action: MCH and CCH records for this processor are not edited correctly 
because the frame set needed to edit them is missing. 


Programmer Response: If SYSREC was the input data set, it may be necessary to 
reinitialize it to make sure that all frames exist. 


IFC1971 





NO FRAMES AVAILABLE {MCH|CCH} MOD pyyy SERIAL 22z2zzzz 


Explanation: (VSE). EREP could not find the frames needed to process the 
MCH or CCH record with this model and serial number. 


System Action: Processing continues. The error record is not edited, or is edited 
with frames for the same model number only. 


Programmer Response: Reinitialize SYSREC, then rerun the job using the 
MERGE parameter. 


IFC198] 





LOG ERR {MCF|CCF} FRAME xx MOD yyyy SERIAL 22222z 


Explanation: (VSE). EREP detected an invalid log type scan code in the frame. 


System Action: This frame is not used. Part of the error record is not edited. 
Processing continues. 


Programmer Response: Reinitialize SYSREC, then rerun the job using the 
MERGE parameter. 


IFC199] 





nnnnnn DIRECTWK READ FAILURES 


Explanation: (VSE). EREP lost nnnnnn records while reading from SYS001. 


System Action: Processing continues. 
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Programmer Response: Rerun the job. If the problem persists, check the direct 
access device on which the data set resides. 


Problem Determination: Table III, items 2, 4, 30. 


IFC2001 





NUMBER OF BYTES REPORTED DIFFERS FROM RECORD COUNT 


Explanation: (MVS, VM, and VSE). The number of sense bytes, or bytes of sta- 
tistical data, expected is not the same as the number of sense bytes recorded by 
the device and specified in the OBR record. EREP formats sense bytes according 
to the original engineering requirements for a device’s EREP support. 


System Action: None. EREP has formatted the number of sense bytes it expected 
to find in the record. 


Programmer Response: This message could appear in the report output when 
either: 


e The number of bytes formatted is less than the total number of bytes the 
device actually recorded in the OBR record. In this case, the message is 
informational; the unformatted sense bytes are not relevant to the EREP 
report. 


OR 


@ The number of bytes formatted is greater than the number of bytes the device 
actually recorded in the OBR record, implying that the byte counts (statistical 
or sense) were recorded erroneously. In this case, the message indicates a 
problem. 

If you suspect that the second case applies, perform problem determination, 

focusing on the device as well as on the system recording process. 


Problem Determination: Table I, items 13, 29. 


IFC2011 





nnnn RECORDS IGNORED DUE TO EXCESSIVE CPUs 


Explanation: (MVS, VM, and VSE). EREP encountered more than 16 unique 
CPUs in the input data. 


System Action: Processing continues. 


Programmer Response: Check the report output to see if the records from the 
CPUs you are interested in were processed. You may need to restrict the number 
of records by use of the CPU or MOD selection parameter. 
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Problem Determination: Table I, items 13, 22, 29. 


IFC214] 





CANNOT PROCESS RECORD: TYPE OR LOGOUT LENGTH 


INVALID 


Explanation: (MVS, VM, and VSE). EREP encountered an MCH or CCH 
record with a logout-length field of zero, or a CCH record produced by a 
non-IBM system or a system other than MVS, VM or VSE. 


System Action: This record is not included in the summary. 


Programmer Response: Check the input record and rerun the job. If the error 
persists, perform problem determination. 


Problem Determination: Table I, items 13, 22, 29. 


IFC215] 





FRAME READ ERROR: MOD pyyy SER 2zzzzz 


Explanation: (MVS, VM, and VSE). EREP’s I/O handler could not read a frame 
record because of an I/O error. 


System Action: Processing continues with the next record. 


Programmer Response: If possible, remount the input volume on another drive 
and rerun the job. If the error persists, perform problem determination. 


Problem Determination: Table I, items 13, 22, 29. 


IFC216! 





UNIDENTIFIED FRAME TYPE xx: MOD yyyy SER 22222z 


Explanation: (MVS, VM, and VSE). During a 303X Detail Summary, EREP 
encountered a frame record type other than the expected MCF or CCF. 


System Action: Processing continues, but this record is not used. 


Programmer Response: Rerun the job. If the error persists, perform problem 
determination. 


Problem Determination: Table I, items 13, 22, 29. 
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IFC217I 





303X LOAD LIST IS FULL 


Explanation: (MVS, VM, and VSE). EREP found the 303X load list in the 
summary-table module already full. 


System Action: EREP terminates summary processing. 


Programmer Response: Rerun the job. If the error persists, perform problem 
determination. This could be a hardware or IBM software problem. 


Problem Determination: Table I, items 13, 22, 29. 


IFC218I 





303X DEFAULT SUMMARY TABLE MODULE mmmmmmmm USED 


Explanation: (MVS, VM, and VSE). EREP used default module mmmmmmmm 
in place of the missing summary module identified in the previously issued 
IFC219I message. 


System Action: EREP continues summary processing using the default summary 
table module named in the message. 


Programmer Response: Make sure the latest release of EREP is installed on your 
system and rerun the job. If the error persists, perform problem determination. 


Problem Determination: Table I, items 13, 22, 29. 


IFC219] 





303X SUMMARY MODULE mmmmmmmm NOT FOUND 


Explanation: (MVS, VM, and VSE). EREP could not find the selected 
mmmmmmmm summary module. 


System Action: EREP omits this record from the summary and continues 
summary processing using the default summary module named in message 
IFC218I. If the default summary-table module is missing, EREP terminates 
summary processing and issues message IFC220I. 


Programmer Response: If message IFC218I immediately fqllows this message, see 
the programmer response for that message. If message IFC220I immediately 
follows, the proper level of EREP is probably not installed. Check with your 
PSR. 
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IFC2201 





SEVERE ERROR. SUMMARY TERMINATED FOR THIS MODEL 


Explanation: (MVS, VM, and VSE). The error mentioned in the immediately 
preceding message caused EREP to terminate the summary. 


System Action: EREP terminates summary processing. 


Programmer Response: See the message immediately preceding this message for 
programmer response. 


IFC2211 





NO SHARE CARD 


Explanation: (MVS, VM, and VSE). EREP found records for more than one 
processor in the input but found no SHARE statements. 


System Action: EREP continues processing; however, the probable failing unit 
could be incorrect for tape devices. 


Programmer Response: Provide SHARE statements for tape devices. 


IFC2231 





tttttttt TABLE ERROR 


Explanation: (MVS, VM, and VSE). The table contains a value or other data 
that EREP does not recognize, or does not contain the data EREP expects; rttttttt 
is one of the following: 


SELECTION CRITERIA 
THRESHOLD 


System Action: EREP stops processing DASD records. 

Programmer Response: The table either is incorrect or has been overlaid. Make 
sure the latest level of EREP is installed and includes all the applicable 
APAR/PTFs. 

If the table has been replaced by PTF, remove the PTF and rerun the job. 


In either case, contact your IBM PSR. 
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IFC225! 





SCAN CODE ERROR xxxxxx, MOD yyyy SER 22z2z2zzz 


Explanation: (MVS, VM, and VSE). During a 303X MCH/CCH Detail 
Summary, EREP found an invalid scan code in a frame record. 


System Action: Processing continues. However, instead of summarizing the indi- 
cators referenced by this frame code, EREP flags them with ‘***’ in the report. 
EREP also issues message IFC226I to further identify the problem. 


Programmer Response: Perform problem determination. 


Problem Determination: Table I, items 13, 22, 29. 


IFC226! 





SUMMARY IN ERROR: FRAME TYPE {MCF|CCF} FRAME ID xx 


Explanation: (MVS, VM, and VSE). The extension of the preceding message, 
IFC225I. 


System Action: See IFC22SI. 


Programmer Response: See IFC225]. 


IFC2271 





NO DASDID CARD FOR ENTRIES FLAGGED WITH * 


Explanation: (MVS, VM, and VSE). EREP found records for DASD devices for 
which there were no DASDID statements. The ‘*’-flagged entries are on the 
DASD Subsystem Exception report. 


System Action: EREP continues processing; however, probable failing unit anal- 
ysis might be incorrect. 


Programmer Response: Include DASDID statements for your DASD that do not 
provide their own physical IDs, and rerun the job. 
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IFC2281 





DASD RECORD THAT RESULTED IN UNKNOWN PFU FOLLOWS 


Explanation: (MVS, VM, and VSE). The following record does not match the 
selection criteria. An error may have occurred in building the record or in the 
selection criteria table; or the record may be from a non-IBM DASD. 


System Action: Processing continues. 


Programmer Response: If the record is from an IBM DASD, contact field support 
to determine where the error occurred. 


Problem Determination: Obtain the following documentation: 


e the record following this message 
e the level of EREP on your system, including APAR/PTFs. 


IFC2291 





MODULE mmmmmmmm, RPA = aaaaaaaa, REQUESTED AN UNSUP- 


PORTED SERVICE FUNCTION; FRF = bbbbbbbb, FCF = cccccccc 


Explanation: (MVS, VM, and VSE). The named module made a service request 
that contained an invalid or unsupported code in the function request flag (FRF) 
or the function control flag (FCF). 


System Action: EREP ignores the request and returns control to the calling 
module at the specified return-point address (RPA). Register 15 contains the 
return code. 

Programmer Response: There is an error either in the product-dependent exit 
module or in the product control table (PCT) for the product. Make sure EREP 


support is installed for the product(s) included in the module name. 


Problem Determination: Save any output for ar-lysis. 


IFC2301 





UNABLE TO TRANSFER CONTROL TO {MOD =mmmmmmmm| PROC 


Pppppppp}; IFCXCST OVERFLOW — CRITICAL ERROR 


Explanation: (MVS, VM, and VSE). The transfer-of-control stack table, 
IFCXCST, is full; EREP cannot transfer control to the named module or proce- 
dure as requested. 
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System Action: EREP ignores the request and returns control to the calling 
module. Register 15 contains the return code. 


Programmer Response: Call IBM Level Two service. 


IFC2311 





UNABLE TO LOAD MODULE mmmmmmmm FOR MODULE xxxxxxxx; 


LMAT OVERFLOW — CRITICAL ERROR 


Explanation: (MVS, VSE, and VM). Module xxxxxxxx requested, via the 
IFCLOAD or IFCCALL macro, that EREP load module mmmmmmmm. EREP 
cannot satisfy the request because the load-module-address table (LMAT) is full. 


System Action: EREP ignores the request and returns control to the calling 
module. Register 15 contains the return code. 


Programmer Response: Call IBM Level Two service. 


IFC232I1 





UNABLE TO GET VIRTUAL STORAGE FOR MODULE mmmmmmmm; 


VSAT OVERFLOW — CRITICAL ERROR 


Explanation: (MVS, VM, and VSE). The named module requested virtual storage 
via the IFCGETM macro. EREP cannot satisfy the request because its virtual 
storage address table (VSAT) is full. 


System Action: EREP ignores the request and returns control to the calling 
module. Register 15 contains the return code. 


Programmer Response: Call IBM Level Two service. 


IFC2331 





INVALID FUNCTION — STE BUILD MODULE mmmmmmmm 


Explanation: (MVS, VM, and VSE). The named module was asked to do some- 
thing it cannot do. 


System Action: Processing continues; EREP does not include this record in the 
System Exception reports. 


Programmer Response: There is an error either in the product-dependent exit 
module or in the product control table (PCT) for the product. Make sure EREP 
support is installed for the product(s) included in the module name. 
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Problem Determination: Save any output for analysis. 


IFC234] 





GETMAIN FOR EVTABLE FAILED 


Explanation: (MVS and VM). EREP was unable to obtain virtual storage for the 
table of valid CPU serial numbers needed for the Event History report. 


System Action: EREP terminates. 


Programmer Response: Increase the region or virtual storage size and rerun the 
job. 


IFC2351 





GETVIS FAILED FOR EVTABLE 


Explanation: (VSE). EREP was unable to obtain virtual storage for the table of 
valid CPU serial numbers needed for the Event History report. 


System Action: EREP terminates. 


Programmer Response: Increase the partition size and rerun the job. 


IFC2361 





GETMAIN FAILED FOR TREND TABLE PART 1 


Explanation: (MVS and VM). EREP was unable to obtain virtual storage for the 
table needed to build Part 1 of the Trends report. 


System Action: No more records are processed; EREP produces a partial report. 


Programmer Response: Increase the region or virtual storage size and rerun the 
job. 


IFC2371 





GETVIS FAILED FOR TREND TABLE PART 1 


Explanation: (VSE). EREP was unable to obtain virtual storage for the table 
needed to build Part 1 of the Trends report. 


System Action: No more records are processed; EREP produces a partial report. 
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Programmer Response: Increase the partition size and rerun the job. 


IFC2381 





GETMAIN FAILED FOR PHYID TABLE 


Explanation: (MVS and VM). EREP was unable to obtain virtual storage for the 
table of physical IDs. 


System Action: Processing continues; this record is excluded from the report. 


Programmer Response: Increase the region or virtual storage size and rerun the 
job. 


IFC2391 





GETVIS FAILED FOR PHYID TABLE 


Explanation: (VSE). EREP was unable to obtain virtual storage for the table of 
physical IDs. 


System Action: Processing continues; this record is excluded from the reports. 


Programmer Response: Increase the partition size and rerun the job. 


IFC2401 





GETMAIN FAILED FOR ACLAS TABLE 


Explanation: (MVS and VM). EREP was unable to obtain virtual storage for the 
additional-classification table used in building the System Summary and Trends 
reports. 


System Action: Processing continues; EREP does no additional classification of 
this record. 


Programmer Response: Increase the region or virtual storage size and rerun the 
job. 
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IFC2411 





GETVIS FAILED FOR ACLAS TABLE 


Explanation: (VSE). EREP was unable to obtain virtual storage for the 
additional-classification table used in building the System Summary and Trends 
reports. 


System Action: Processing continues; EREP does no additional classification of 
this record. 


Programmer Response: Increase partition size and rerun the job. 


IFC2421 





EXIT MOD mmmmmmmm COULD NOT OBTAIN ERROR CLASS 


Explanation: (MVS, VM, and VSE). Either the named module could not load the 
PCT containing the product-dependent data for this record, or the PCT did not 
contain the expected error class. 


System Action: Processing continues; this record is excluded from the report. 
Programmer Response: There is an error either in the product-dependent exit 


module or in the product control table (PCT) for the product. Make sure EREP 
support is installed for the product(s) included in the module name. 


IFC2431 





EXIT MOD mmmmmmmm COULD NOT OBTAIN PHYSICAL ID 


Explanation: (MVS, VM, and VSE). Either the named module could not load the 
PCT containing the product-dependent data for this record, or the PCT did not 
contain the expected physical ID. 


System Action: Processing continues; this record is excluded from the report. 
Programmer Response: There is an error either in the product-dependent exit 


module or in the product control table (PCT) for the product. Make sure EREP 
support is installed for the product(s) included in the module name. 
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IFC2441 





EXIT MOD mmmmmmmm COULD NOT OBTAIN VOLID 


Explanation: (MVS, VM, and VSE). Either the named module could not load the 
PCT containing the product-dependent data for this record, or the PCT did not 
contain the expected volume serial number. 


System Action: Processing continues; this record is excluded from the report. 
Programmer Response: There is an error either in the product-dependent exit 


module or in the product control table (PCT) for the product. Make sure EREP 
support is installed for the product(s) included in the module name. 


IFC245] 





EXIT MOD mmmmmmmm COULD NOT OBTAIN SYMCDE 


Explanation: (MVS, VM, and VSE). Either the named module could not load the 
PCT containing the product-dependent data for this record, or the PCT did not 
contain the expected fault symptom code 


System Action: Processing continues; this record is excluded from the report. 
Programmer Response: There is an error either in the product-dependent exit 


module or in the product control table (PCT) for the product. Make sure EREP 
support is installed for the product(s) included in the module name. 


IFC2461 





EXIT MOD mmmmmmmm COULD NOT OBTAIN TERMINAL NAME 


Explanation: (MVS, VM, and VSE). Either the named module could not load the 
PCT containing the product-dependent data for this record, or the PCT did not 
contain the expected terminal name. 


System Action: Processing continues; this record is excluded from the report. 


Programmer Response: There is an error either in the product-dependent exit 
module or in the product control table (PCT) for the product. Make sure EREP 
support is installed for the product(s) included in the module name. 
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IFC247I 





EXIT MOD mmmmmmmm COULD NOT OBTAIN LIA/LIBADR 


Explanation: (MVS, VM, and VSE). Either the named module could not load the 
PCT containing the product-dependent data for this record, or the PCT did not 
contain the expected line interface base address. 


System Action: Processing continues; this record is excluded from the report. 
Programmer Response: There is an error either in the product-dependent exit 


module or in the product control table (PCT) for the product. Make sure EREP 
support is installed for the product(s) included in the module name. 


IFC2481 





GETMAIN FAILED FOR SYSUM TABLE PART 1 


Explanation: (MVS and VM). EREP was unable to obtain virtual storage for the 
table needed to build Part 1 of the System Summary. 


System Action: No more records are processed; EREP produces a partial report. 


Programmer Response: Increase region or virtual storage size and rerun the job. 


IFC249] 





GETVIS FAILED FOR SYSUM TABLE PART 1 


Explanation: (VSE). EREP was unable to obtain virtual storage for the table 
needed to build Part 1 of the System Summary. 


System Action: No more records are processed;,EREP produces a partial report. 


Programmer Response: Increase partition size and rerun the job. 


IFC2501 





EXIT MOD mmmmmmmm COULD NOT OBTAIN SFT DATA 


Explanation: (MVS, VM, and VSE). The named module supplies product- 
dependent data for the Event History report. It was unable to find the data for 
this software (SFT) record. 
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System Action: Processing continues; however, the entry for this record will not 
include the product-dependent data. 


Programmer Response: There is an error either in the exit module or in the 


product control table (PCT) for the product. Make sure EREP support is 
installed for the product(s) included in the module name. 


IFC251I 





EXIT MOD mmmmmmmm COULD NOT OBTAIN OBR DATA 


Explanation: (MVS, VM, and VSE). The named module supplies product- 
dependent data for the Event History report. It was unable to find the data for 
this OBR record. 


System Action: Processing continues; however, the entry for this record will not 
include the product-dependent data. 


Programmer Response: There is an error either in the exit module or in the 


product control table (PCT) for the product. Make sure EREP support is 
installed for the product(s) included in the module name. 


IFC2521 





EXIT MOD mmmmmmmm COULD NOT OBTAIN CCH DATA 


Explanation: (MVS, VM, and VSE). The named module supplies product- 
dependent data for the Event History report. It was unable to find the data for 
this CCH record. 


System Action: Processing continues; however, the entry for this record will not 
include the product-dependent data. 


Programmer Response: There is an error either in the exit module or 1n the 


product control table (PCT) for the product. Make sure EREP support is 
installed for the product(s) included in the module name. 


IFC2531 





EXIT MOD mmmmmmmm COULD NOT OBTAIN MDRDASD DATA 


Explanation: (MVS, VM, and VSE). The named module supplies product- 
dependent data for the Event History report. It was unable to find the 
DASD-specific data for this MDR record. 


System Action: Processing continues; however, the entry for this record will not 
include the product-dependent data. 
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Programmer Response: There is an error either in the exit module or in the 
product control table (PCT) for the product. Make sure EREP support is 
installed for the product(s) included in the module name. 


IFC256I 





UNABLE TO LOAD MODULE mmmmmmmm FOR MODULE 


IFCZIMGR 


Explanation: (MVS, VM, and VSE). During initialization of the EREP run, the 
named service module could not be found or loaded. 


System Action: EREP terminates. 


Programmer Response: Make sure the named module is included in the library 
being searched during initialization and try again to run EREP. 


IFC2571 





UNABLE TO INITIALIZE IFCZIMGR FOR mmmmmmmm 


Explanation: (MVS, VM, and VSE). EREP could not initialize its system inter- 
face manager (IFCZIMGR) for the named module. Either it could not load a 
needed service module or it could not open the TOURIST/SYSLST data set. The 
reason is indicated in the preceding message. 


System Action: EREP terminates. 


Programmer Response: Take the action recommended for the preceding message 
and try again. 


IFC2581 





EXIT MOD mmmmmmmm COULD NOT FORMAT REPORT FOR ssrr 


Explanation: (MVS, VM, and VSE). The named module produces the product- 
dependent Detail Summary Report. It was unable to produce the report for this 
SCP (ss) and record type (rr). The record type is byte 0 of the record. Fora 
description of the various record types see Figure 10-6 on page 10-12. The SCP 
is one of the following: 


e VM 
@ VE (VSE) 
e V2 (MVS) 


System Action: Processing continues; however, the Detail Summary Report for 
this SCP and record type will not be produced. 
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Programmer Response: There is an error either in the exit module or in the 
product control table (PCT) for the product. Make sure EREP support is 
installed for the product(s) included in the module name. 


IFC2591 





EXIT MOD mmmmmmmm COULD NOT OBTAIN DATA FOR ssrr 


Explanation: (MVS, VM, and VSE). The named module supplies product- 
dependent data for the Event History Report. It was unable to produce the 
report for this SCP (ss) and record type (rr). The record type is byte 0 of the 
record. For a description of the various record types see Figure 10-6 on 
page 10-12. The SCP is one of the following: 


e VM 
e VE (VSE) 
e@ V2 (MVS) 


System Action: Processing continues; however, the entry for this record will not 
include the product-dependent data. 


Programmer Response: There is an error either in the exit module or in the 


product control table (PCT) for the product. Make sure EREP support is 
installed for the product(s) included in the module name. 


IFC2601 





USER EXIT MOD mmmmmmmm COULD NOT BE LOADED FOR EREP 


Explanation: (MVS, VM, and VSE). The named module supplies product- 
dependent data for the Event History Report. EREP was unable to load it. 


System Action: Processing continues; however, the entry for this record will not 
include the product-dependent data. 


Programmer Response: There is an error in the product control table (PCT) for 
the product. Make sure EREP support is installed for the product(s) included in 
the module name. 
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CPEREP Messages 


Cc Introduction to DMS-prefixed EREP Messages 


The CPEREP command processor can issue messages to the VM user that have 
to do with CPEREP rather than EREP itself. Because CPEREP runs under the 
VM/SP Conversational Monitor System (CMS), its messages carry the DMS 
prefix in addition to EREP’s IFC.? 


The following table summarizes the source and format of the DMS-prefixed 
EREP messages as presented in this book: 


Component prefix: DMSIFC? 


Program producing messages: CPEREP (CMS) 


Where produced: On the output device; usually, the display terminal 
screen. 

Audience: System programmer 

Message format: DMSIFCnank|I|S|W text 


nnn is the message serial number. 
E indicates an error message 


I indicates an informational message 


dl 
S indicates a severe error 
W sindicates a warning message 
text is the text of the message. 
C 2 Message 830E is prefixed by DMSREA because it is issued by DMSREA, the 


CPEREP read module, instead of DMSIFC. 
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DMSIFC002E 





[INPUT|OVERLAY] {FILE(S)|DATA SET|NOTE} fn ft fm NOT FOUND 


Explanation: The specified file was not found on the accessed disk(s). Either: 


e@ the file does not reside on this disk, or 
e the file was identified incorrectly, or 
e the system disk was not accessed as a read-only extension of the A-disk. 


See the VM/SP CMS Command and Macro Reference, and “Defining Files for 
CPEREP” in this book for descriptions of the file identification required and the 
search procedure used. 

Return Code: 28 

System Action: Execution halts. System status remains the same. 

User Response: Find or create the desired file. To make sure that the file exists, 


issue STATE fn ft * or LISTFILE fn ft *. Correct and reissue the 
command. 


DMSIFC007E 





FILE fn ft fm [IS] NOT FIXED, 80 CHAR. RECORDS 


Explanation: The specified file must have fixed-length, 80-character records in 
order for the command to be executed. 


Return Code: 32 
System Action: Execution halts. System status remains the same. 


User Response: It is possible that an incorrect file[D was specified in the 
command line. In this case, reissue the command. If, however, the fileID was 
correct but the file is in the wrong format or does not contain 80-character 
records, change the file’s format and/or record length with the COPYFILE or 
EDIT command. 
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DMSIFC023E 





NO FILETYPE SPECIFIED 


Explanation: When CPEREP operands are in a separate file, you must include 
both the filename and the filetype on the command. 


Return Code: 24 
System Action: Execution halts. System status remains the same. 


User Response: Reenter the command, specifying the filename and filetype. 


DMSIFCO070E 





INVALID {PARAMETER parameter, ARGUMENT argument} 


Explanation: An invalid operand was specified for CPEREP. If the operands are 
in a separate file, there may be too many on a line. 


Return Code: 24 
System Action: Execution halts. System status remains the same. 


User Response: Correct the operand and reissue the CPEREP command. 


DMSIFC104S 





ERROR xx READING FILE fn ft fm FROM DISK 


Explanation: An unrecoverable error occurred while reading the file from disk. 
xx indicates the nature of the error, and can be one of many codes. See VM/SP 
System Messages and Codes for the possible codes and their meanings. 


Return Code: 100 or 1xx; same as the code in the message. 


System Action: Execution halts. The system status remains the same as before the 
command was issued. 


User Response: Retry the command. If the problem persists, call your system 
support personnel. 


If the code is a 3 (permanent disk read error), it could be the result of your 


having detached a virtual disk without releasing it. CMS assumed the disk is still 
active and encountered an error when it tried to read the file. 


CPEREP Messages 11-49 


DMS*** Messages 


DMSIFC825E 





CLEAR IS VALID ONLY WHEN SPECIFIED BY ITSELF 


Explanation: CLEAR or CLEARF was specified along with other parameters. 
This is prohibited. —The CLEAR parameter must be specified by itself, with no 
reports requested. 


Return Code: 12 


System Action: Execution halts. System status remains the same. No clearing 
takes place. No report is printed. 


User Response: If you want the report, reissue the CPEREP command requesting 
the report without the CLEAR parameter. Include the ZERO parameter to clear 
the error-recording area after the report is completed. If you want only to clear 
the ERDS, reissue CPEREP specifying only the CLEAR/CLEARF operand. 
(However, see message DMSIFC829W.) 


DMSIFC826E 





EREP TXTLIBS NOT FOUND 


Explanation: In attempting to search the EREP TXTLIBs, DMSIFC found that 
the pointer to the first TXTLIB contained zeros. 


Return Code: 56 
System Action: Execution halts. System status remains the same. 
User Response: Issue a GLOBAL TXTLIB command listing the applicable EREP 


TXTLIBs in the proper search order. If no local libraries exist, the command 
should be: 


GLOBAL TXTLIB ERPTFLIB EREPLIB 


Reissue the CPEREP command. If the problem persists, call your system support 
personnel. 


DMSIFC828I1 





CPEREP ZERO OR CLEAR HAS BEEN COMPLETED 


Explanation: CLEAR/CLEARF or ZERO was specified by the user, or other 
parameters caused ZERO to be requested by default. The VM error-recording 
cylinders have been erased. If CLEARF was specified, the 303X MCH and CCH 
frame records were updated. 
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Return Code: 0 
System Action: Control returns to CMS. 


User Response: None required. 


DMSIFC829W 





ATTEMPTED ’ZERO’ WAS SUPPRESSED. REQUIRES PRIVILEGE 


CLASS F 


Explanation: CLEAR or ZERO was specified by the user, or other parameters 
caused ZERO to be requested by default. The VM/370 error-recording cylinders 
were not erased because the user was not authorized to do so. Only class F users 
can erase the error-recording area. 


Return Code: 88 or 0 

System Action: If the CLEAR function failed, the return code is 88. If the ZERO 
function failed, the return code will be 0. Reports (if requested) have already 
been generated. Control returns to CMS. 

User Response: None required if ZERO was requested by mistake or default. If 


you need to erase the error-recording cylinders, see your system support personnel 
to get a class F directory entry. 


DMSIFC831E 





MORE THAN 100 CHARS OF OPTIONS SPECIFIED 


Explanation: The maximum number of characters that can be used to specify 
CPEREP operands is 100. More than 100 characters were used. 


Return Code: 62 
System Action: Execution halts. System status remains the same. 


User Response: Check the valid command options. Reissue the command using 
fewer than 100 characters to specify the options. 


DMSIFC832S 





SOFTWARE INCOMPATIBILITY AT THE CPEREP-EREP INTER- 


FACE. CODE= xxx 


Explanation: CPEREP is MVS EREP running under CMS with CPEREP pro- 
viding interface code between MVS EREP and CMS. Some change has been 
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made to MVS EREP (via PTF, or a new release) that has made it incompatible 
with the interface provided by CPEREP. xxx is one of the following reason 
codes: 


Code Meaning 


001 


002 


003 


004 


005 


006 


007 


008 


009 


010 


An EXCP was attempted with a DCB other than that of the 
SYS1.LOGREC data set. 


MVS EREP is expected to use only one IOB and one channel program 
when it uses EXCP to access the SYS1.LOGREC data set. But it has 
attempted to use IOBs or channel programs at more than one location in 
storage. 


The expected read/write command in the channel program for accessing 
SYS1.LOGREC contains an unexpected op code. 


While reading error records (with EXCP) from (simulated) SYS1.LOGREC, 
MVS EREP made an attempt to read nonsequentially prior to completion 
of the sequential reading phase. 


An attempt was made to read record 2 of SYS1.LOGREC (the time stamp 
record), which CPEREP does not simulate. 


The first EXCP to SYS1.LOGREC was not the expected read of the 
SYS1.LOGREC header record. 


The channel program for accessing SYS1.LOGREC does not have the 
expected format. 


An invalid disk address (CCHHR) was used while attempting to access 
SYS1.LOGREC. 


There are no error records and yet MVS EREP attempted to read error 
records. 


An invalid record length was encountered while reading SYS1.LOGREC. 
This may be due to error records being overlaid on the error cylinders. 


Return Code: 104 


System Action: CPEREP terminates with EREP message(s) IFC135I or IFC149I. 


User Response: Reissue the command, or have your system programmer try it. If 
the problem persists, call your system support personnel. 


11-52  EREP User’s Guide 


J 


DMS*** Messages 


DMSREA830E 





I/O ERROR READING A BLOCK OF RECORDS FROM THE ERROR 


RECORDING CYLINDERS 


Explanation: DMSREA, the CPEREP read module, encountered a permanent 
input/output error while attempting to read a 4K block of records from the error- 
recording area. Probable hardware error. 


Return Code: 60 

System Action: Execution halts. System status remains the same. 

User Response: Execute the DDR service program to obtain a dump of the error 
recording cylinder on which the input error occurred. Reconstruct the data on 


the error-recording cylinders. If the reconstruction process is successful, try the 
CPEREP operation again. If the error recurs, call your system support personnel. 
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Problem Determination Aids 


EREP Return Codes 


Sometimes, you must go through the process of problem determination in order 
to identify a failing hardware unit or program and determine who 1s responsible 
for fixing it. This section of the EREP User's Guide presents three different aids 
to problem determination: 


1. the EREP return codes, 
2. general problem determination tables and 


3. the EREP DEBUG parameter. 


In addition to the IFC**** messages, EREP issues the following return codes 
when it stops processing: 


(Decimal) 

Return Code Meaning 

00 No errors 

04 Warning 

08 Severe error (non-terminating) 
10 Severe error (non-terminating) 
12 Severe error (terminating) 

16 Catastrophic error 


A return code of 12 or greater means that EREP has terminated abnormally; it 
cannot complete the report. With a return code of 04 processing continues; the 
report will be complete but might not contain all possible records. With return 
codes 08 and 10, processing may or may not continue, depending on the kind of 
error EREP has encountered. If processing does continue, the report will likely 
be incomplete. 


EREP (IFCEREP]) issues at least one IFC**** message for every return code 
greater than 04; it also issues messages for some situations that produce return 
codes of 04. The messages could appear in the TOURIST output or in the body 
of the report output. 


11-54  EREP User’s Guide 


J 


L 


PD Tables 


Problem Determination Tables 


Problem determination includes using procedures specified by IBM to arrive at 
the probable cause of an error that resulted in a message; it is part of the system 
programmer’s response to the message. 


Many of the descriptions of messages in this book are followed by the numbers of 
tables and items (Problem Determination: Table I, items 2, 4, 29, for example). 
The numbers correspond to the tables, and items in them, that appear on the fol- 
lowing pages. 


The actions prescribed in the problem determination tables are those recom- 
mended to diagnose problems with an SCP; they may not all be applicable to 
your problem. However, they will help you document the problem in case you 
have to call IBM for help in fixing it. 


Table I and Table II are meant for MVS users; they include standard problem 
determination procedures for an MVS system, and the use of the Generalized 
Trace Facility (GTF) to isolate and document an error. Table III presents the 
standard problem determination procedures for VSE systems. 


VM users can perform problem determination online, using the VM control 
program to investigate the virtual machine’s operating system, whether it be MVS 
or VSE. The version of the VM OLTSEP and Error Recording Guide that applies 
to your VM facility contains more information about using VM to diagnose prob- 
lems. 
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TABLE I. STANDARD PROBLEM DETERMINATION FOR MVS SYSTEMS 


l. 
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If MSGLEVEL = (1,1) was not specified in the JOB statement, specify it and 
rerun the job. 


Save the console sheet from the primary console. In systems with remote 
consoles, save the remote console sheet. In systems with Multiple Console 
Support (MCS), save a copy of the hard-copy log. 


Save the jobstream associated with the job. 
Save the system output (SYSOUT) associated with the job. 
Make sure the failing job step includes a: 


a. SYSABEND DD statement. 
b. SYSUDUMP DD statement. 
c. PLIDUMP DD statement. 
d. SYSMDUMP DD statement. 


Make sure the PARM parameter of the EXEC statement specifies the fol- 
lowing: 


MAP 

LIST 

DIAG 

MSG-AP 

CORE (if applicable) 
XREF 

DUMP 


Rime ao gE 


If SMP is used to make all changes to the system, execute the LIST CDS and 
LIST PTFBY functions of SMP to obtain a list of the current maintenance 
from the SMP control data set (CDS). If any changes are made to the system 
without using SMP, execute the LISDIR function of the BLIST (VS2), or 
HMBLIST (VS1) service aid program to obtain a list of all members with a 
PTF or local fix, and save the output. Execute the program against the: 


SYS1.LINKLIB data set. 
SYS1.SVCLIB data set. 


Library containing the program that issued the message. 
SYS1.LPALIB data set. 


a ae 


Execute the IMCJOBJQD (stand-alone) or IMCOSJQD (system-assisted) 
service aid program to obtain a formatted copy of the contents of the 
SYS1.SYSJOBQUE or SYS1.SYSWADS data sets, SWADS or the resident 
job list. 


J 


20. 


21. 


Ze: 


23. 


PD Tables 


Execute the BLIST (VS2), or HMBLIST (VS1) service aid program to obtain: 


a. an object module listing, specifying the LISTOBJ function. 
b. a load module map and cross-reference listing, specifying the OUTPUT 
BOTH option of the LISTLOAD function. 


. Have a copy of the Message Control Program (MCP) available. 


. Execute the SADMP (VS2), or HMDSADMP (VS1) service aid program to 


dump the contents of real storage and page data sets to magnetic tape. 


After restarting the system, execute the appropriate function of the PRDMP 
(VS2), or HMDPRDMP (VS1) service aid program to print the required 
portion of the dump tape produced by SADMP. 


Save the tape from SADMP (VS2), or HMDSADMP (VS1), in case further 
information from the tape 1s required, and the listing from the PRDMP. 


. Execute the SEREP program, and save the resulting output. 
. Save all the associated output. 


. The normal response to this message is for the programmer/operator to 


execute a specific program. Save all output from that program. 


. Save the program listing associated with the job. 
. Save the dump. 


. Have the system generation (SYSGEN) output available from: 


a. Stage I 
b. Stage II 


. Execute IFCEREP1 to dump the SYS1.LOGREC data set and save the 


resulting output. 


For MSS, execute the following program to dump the SYS1.LOGREC data 
set: 


a. Service aid IFCISDAO. 
b. Program ISDASDAO with the DETAIL (ALL) parameter. 


. Save the assembly listing associated with the job. 


Save the control cards associated with the job. 
Save the compiler output associated with the job. 
Save the source input associated with the job. 


Save the source program listing associated with the job. 
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24. 


25. 


26. 


24: 


28. 


29. 


30. 


31. 


52: 


33. 


34. 


35. 


36. 
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Run OLTEP diagnostics for the problem device and save the output. 
Execute the IEHLIST system utility program to obtain a list of the: 


a. volume table of contents of the associated volume, specifying the 
FORMAT option. 

b. volume table of contents of the associated volume, specifying the DUMP 
option. 

c. Directory of the associated data set. 

d. System catalog. 


Execute the IEBPTPCH data set utility to print the: 


directory of the applicable data set. 
applicable data set. 

applicable member. 

applicable procedure. 


Bes oS 


Have the linkage editor/loader map available. 
Save the associated volume. 

Contact IBM for programming support. 
Contact IBM for hardware support. 

Save the trace output data set. 


Print the GTF trace data set, using the PRDMP (VS2), or HMDPRDMP 
(VS1) service aid program with the EDIT statement. 


Print the associated SVC dump data set, using the PRDMP (VS2), or 
HMDPRDMP (VS1) service aid with the GO statement. 


Execute the Access Method Services LISTCAT command to: 


a. list the contents of the applicable catalog. 
b. list the catalog entries for the applicable objects and any related objects. 


Execute the following access method services command: 


a. MSS LISTMSF for mountable volumes. 

b. MSS LISTMSF with the CARTRIDGES parameter. 

c. PRINT to list the contents of the MSVC (Mass Storage Volume Control) 
inventory data set. 

d. LISTMSVI. 

e. LISTMSF with the ALL parameter. 


Execute the Access Methods Services PRINT command to print the repair 
workfile. 


J 


37. 


38. 


39. 


40. 


41. 


42. 


43. 


44. 


45. 


46. 


47. 


PD Tables 


Execute the SPZAP service aid program using the ABSDUMP statement to 
print the contents of the applicable: 


a. data set. 
b. track. 


Execute the Access Method Services AUDITMSS command with the fol- 
lowing parameter: 


a. CHECK 
b. MAP 
c. READLABEL 


Execute the Access Method Services CHECKMSS command. 
Execute the Access Method Services COMPARED command. 


Execute the Access Method Services DUMPMSS command to dump the fol- 
lowing: 


Formatted Mass Storage Control storage. 
Mass Storage Control main storage. 
Mass Storage Control extended storage. 
Formatted Staging Adapter storage. 
Staging Adapter main storage. 

Staging Adapter extended storage. 

Mass Storage Control tables. 


mmoaogre 


Save the latest output from the Mass Storage Control Table Create program. 


Display units for units associated with the problem area. If the specific 
unit(s) is now known, display the range of all virtual units. See your config- 
uration path chart for address ranges. 


Obtain the RACF profile of the associated data set, where applicable. 

Stop one CPU and use the hardware ALTER/DISPLAY facility to display: 

a. all general-purpose registers 

b. the PSW 

c. main storage locations 0 through 200 (hexadecimal) and 7000 through 
7080 (hexadecimal). 

If the SADMP program resides on tape, save the tape. If the SADMP 

program resides on disk, use the DUMP feature of IEHDASDR to print the 

SYS1.PAGEDUMP data set and cylinder 0 track 0 of this residence disk. 


Save the output (listings) of the stage 1 and stage 2 SADMP initialization 
jobs. 
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48. 


49. 


50. 


D1: 


52: 


53: 
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Follow the procedures for item 9b on page 11-57 of this table for load 
modules: J 
a. A/HMDSAPGE 

b. A/HMDSAPRO 

c. A/HMDSALDR 

of SYS1.LINKLIB. Use IEBUPDTE or IEBPTPCH to print the 

A/HMDSADMP and A/MDSADM2 macros from SYS1.MACLIB. 


Save the A/HMDSADMP dump output (tape or listing). 

If the program seems to be looping, use the display PSW feature of the hard- 
ware ALTER/DISPLAY facility along with the hardware instruction Step 
facility to trace the loop, instruction by instruction. 

If there is an error in the contents of a page data set dump, restart the system 
using a different page data set, then dump the original page data set using the 
DUMP feature of IEHDASDR. 

Use IEBCOPY to unload SYS1.IMAGELIB to tape. 


Have a list of RACF-defined entities available. 


C 
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TABLE II. USING GTF FOR PROBLEM DETERMINATION 


Format 1: Tracing Without Prompting for Event Keywords 


Before reproducing the problem, have the system operator issue a START GTF 
command specifying tape output, MODE EXT and TIME=YES. In response to 
message AHHLIO0A (VS2), or HHL100A (VS1), he should type TRACE = opt, 
where opt is the trace option indicated for the particular message or code. 


When data for the problem has been recorded, run the PRDMP (VS2), or 
HMDPRDMP (VS1) service aid program using the EDIT statement to format the 
trace output, specifying DDNAME (ddname of the trace data set). 


Format 2: Tracing With Prompting for Event Keywords 


Before reproducing the problem, have the system operator issue a START GTF 
command specifying tape output, MODE=EXT and TIME=YES. In response 
to the message AHHL100A (VS2), or HHL100A (VS1) he should specify the trace 
options indicated for the associated message or code within the text of his reply. 


Then, in response to the message AHHLIOIA (VS2) or HHLIOIA (VSI), he 
should specify the event keywords also indicated with the associated message or 
code. 


When data for the problem has been recorded, run the PRDMP (VS2), or 
HMDPRDMP (VSI) service aid program using the EDIT statement to format the 
trace output, specifying DDNAME (ddname of the trace data set). 


Format 3: Specialized Tracing Action 


Before reproducing the problem, have the system operator issue a START GTF 
command specifying tape output MODE=EXT and TIME=YES. In response to 
message AHHL100A (VS2), or HHLI01A (VS1), he should type 
‘TRACE=SYS.USR’. The DD statement for a data set in error should specify 
DCB = DIAGNS= TRACE. 


When data for the problem has been recorded, execute the EDIT function of 
PRDMP (VS2), or HMDPRDMP (VS1), specifying the options SYS and 
USR=FFF. 
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TABLE III. STANDARD PROBLEM DETERMINATION FOR VSE SYSTEMS 


2. 


4. 

13. 
29. 
30. 


Note: 
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Save the console sheet from the operator console. In systems with a DOC, 
save a copy of the hard-copy log. 


Save the system output (SYSLST) associated with the job. 
Save all the associated output. 

Contact IBM for programming support. 

Contact IBM for hardware support. 


For a more complete description, refer to the Serviceability Aids and Debug- 
ging Procedures manual that applies to your system. 


J 


C 


DEBUG Options 


The EREP DEBUG Parameter 


Syntax 


When you need to see the actual input to EREP — as is recommended in several 
messages — one way to look at the error records is to run EREP again, specifying 
one of the DEBUG parameter options. Other DEBUG options give access to the 
communication and data areas used by the modules that make up the EREP 
program, to help in diagnosing problems within EREP itself. 


Note: You should undertake the debugging of the EREP program only under the 
direction of an IBM service representative. If you suspect a problem exists, 
your first action should be to call the IBM Service Center for your area. 


Because this book is primarily for IBM customers, it includes only those DEBUG 


options available and recommended for customer use; your IBM service represen- 
tative can advise you further, if necessary. 


The DEBUG parameter can be included in any EREP run. Its syntax is: 


DEBUG=(nn[,nn] ...) 


nn is the one- or two-digit decimal number assigned to an EREP DEBUG 


option. 
Indicates: That EREP is to print as part of the report output the infor- 
mation indicated by the specified option(s). 
Default: None. 
Debugging information is not normally printed. 
Coding: The same rules and conventions apply as for other EREP 


keyword parameters. 


Parameter Conflicts: None. 
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Options 


The following DEBUG options are available for customer use: 


Option 
Number 


4 


17 


45 


49 
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Meaning 


Print the name and compile date of all control modules. Print the 
start and stop times of each routine called by IFCEREP1. The infor- 
mation appears in the TOURIST output. 


Print a hexadecimal dump of every record that passed filtering. The 
records appear in the Event History report, one following each normal 
data line. 


Print a hexadecimal dump of a frame record from module 
IFCZFRME. The record appears only in an MCH or CCH Detail 
PRINT report. 


Print a hexadecimal dump of all the frame records from module 
IFCZFST1. This option, too, is for MCH and CCH Detail PRINT 
reports only. 


Chapter 12. Summary of Tables and Charts 


The following pages contain miscellaneous charts and tables that summarize refer- 
ence information about EREP in various ways. In a some cases, the charts in this 
chapter are duplicates of ones in Chapter 1; they are here so their information is 
readily available when you are using the book in reference mode. 
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Incorrect Parameter Combinations 


Incorrect EREP Parameter Combinations 


Figure 12-1 shows all the EREP record selection and processing parameters and 
indicates which are mutually exclusive. For example, ACC is valid with all other 
parameters except DEVSER; and ZERO is valid only with some processing 
parameters and MODE=ALL. 
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Figure 12-1. Incorrect EREP Selection/Processing Parameter Combinations 























Notes: 


1. DEVSER is used for the Threshold Summary only, so the only valid devices are 
3410, 3420, 8809 and 34XX. 


2. LIA/LIBADR applies only to TP communication controllers, so the only valid 
devices are 3705 and 3725. 


3. DEV is valid with only four record types: DDR (D), MIH (H), OBR (QO) and 
MDR (M). 
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Incorrect Parameter Combinations 


VOLID applies only to 33XX DASD and 34XX tape devices. 
ZERO is valid if you code or default MODE = ALL. 


In EREP 3.1 and later, this combination is meaningless but not invalid. In 
earlier versions of EREP, it is considered a parameter conflict. 
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Record Types and Reports 


Error Records and the EREP Reports J 


The following figure shows the various record types processed by EREP, and the 
reports that use those record types. Note that there is some overlap among device 
type groups and record types. 


REPORT RECORD TYPES SOURCE 


System Summary CCH/CRW/SLH Processors, channels 
IPL SCP 
Termination (EOD) SCP 
MCH Processors 






























MDR 
OBR 


1/O devices, including 
SCUs, controllers 










SFT MVS operating system 











System Exception Reports: 
System Error Summary 
Parts 1 and 2 













IPL/EOD 
MCH 
CCH 


SCP 
Processors 
Processors, channels 
















DDR 
OBR 


1/O devices, including: 
channel 
SCU 
controller 
device 
volume 













Processors, channels 
Processors 


Subsystem Exception 






33XX DASD, 34XX Tape 







DASD Summaries SCUs, controllers, devices 










Tape Summaries Controllers, devices 


Trends Report 


Event History 

















IPL 
CCH/CRW/SLH 
Software (SFT) 


SCP 
Processors, channels 
SCP 
















OBR 
MDR 


CCH/CRW/SLH 
DDR 

EOD 

IPL 

MCH 

MDR 

MIH 

OBR 

SFT 

A 


Threshold Summary MDR 
OBR (including 3410, 3420, 
demounts) 8809 tape devices 
PRINT Reports All but DASD MDR All products/devices. 


Figure 12-2. The Records in EREP Reports 


I/O devices 





All hardware, plus software errors 
and events 
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EREP Report Parameters 


C Report Parameter Summary 


The following figure contains the same information as Figure 1-5 in 
Chapter 1, “Introduction to EREP.” 


REPORT 

PARAMETERS | WHAT THEY DO 

EVENT Produces an Event History report, a chronological pres- 
entation of one-line abstracts from the selected records. 
It has two parts. 

PRINT Produces a series of Detail Edit and/or Summary reports 
for the selected record types. The number of reports 
depends on the input and selection parameters. 

way to run EREP without producing any report 
output is to code PRINT= NO. 

SYSEXN Produces a System Exception report series, reports cov- 
ering processors, channels, DASD and tape subsystems. 

SYSUM Produces a System Summary, a condensed two-part 
report of all errors for the principal system elements - 
CPU, channels, storage, SCP, I/O Subsystem. 

THRESHOLD Produces a summary of a tape subsystem, including 
media statistics and permanent errors that exceed the 
limits set on the parameter itself. 


TRENDS 


Figure 12-3. Report Parameters for EREP 





















Note: PRINT is the default report parameter. The only 












Produces an expanded version of the System Summary, 
presenting error records logged by or for the various 
system elements during 30 days, at most. Like the 
System Summary, it has two parts. 
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EREP Selection Parameters 


Selection Parameter Summary 
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The following figure contains the same information as Figure 1-6 in 
Chapter 1, “Introduction to EREP.” 


SELECTION 

PARAMETERS | WHAT THEY DO 

CPU (Processor serial and machine type numbers). Tells 
EREP to use only the records associated with this partic- 
ular processor. 

CPUCUA (Processor serial number and device address). Tells 
EREP to use only the records associated with this device 
attached to this processor. 

CUA (Device address or number). Tells EREP to use only the 
records associated with this particular device address or 
device number. 

DATE Tells EREP to use only the records created during this 

date range. 

V 

DEVSER (Device serial number). Tells EREP to use only the 

D 


34XX tape records associated with this tape device serial 
number. 


ERRORID (Error identifier). Tells EREP to use only the MVS soft- 
ware records containing this particular error identifier. 

LIA/LIBADR (Line interface [base] address). Tells EREP to use only 
the 3705 or 3725 communication controller records con- 
taining this line interface address. 

MO (Processor model). Tells EREP to use only the records 
containing this processor machine type (number). 

MODE (370 or 370-XA). Tells EREP to use only the records 
created in this operating mode. 

SYMCDE (Fault symptom code). Tells EREP to use only the 
33XX DASD records containing this particular fault 
symptom code. 

TERMN (Terminal name). Tells EREP to use only the VTAM or 
TCAM OBR records containing this terminal name. 

TIME Tells EREP to use only the records created during this 
time range. 

TYPE (Record type). Tells EREP to use only the records of the 
specified type(s). 


VOLID (Volume serial number). Tells EREP to use only the 
33XX DASD or 34XX tape records containing this 
volume serial number. 


Figure 12-4. Selection Parameters for EREP 


DE (Device type). Tells EREP to use only the records associ- 
ated with this particular device type; or, conversely, not 
to use the records associated with this device type. 





EREP Processing Parameters 


Cc Processing Parameter Summary 


The following figure contains the same information as Figure 1-7 in 
Chapter 1, “Introduction to EREP.” 


PROCESSING _|- 

PARAMETERS | WHAT THEY DO 

ACC (Accumulate). Tells EREP to copy the records used for 
the report onto an output history data set. 

HIST (History). Tells EREP that its input consists of records 
on a history data set. 

LINECT (Line count). Tells EREP that each page of the report 
output is to contain this number of lines. 

MERGE (Merge). Tells EREP that its input consists of records 
from both the ERDS and a history data set. 


SHORT (Short OBR). Tells EREP to print out short-form OBR 
records in Detail Edit report output. 


TABSIZE (Table size). Tells EREP that the sort table it uses for 
internal processing is to be this big. 

ZERO (Zero ERDS). When this report is complete, EREP is to 
clear the error-recording data set (SYSREC, or 
SYS1.LOGREC, or the error recording area). 


Figure 12-5. Processing Parameters for EREP 
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EREP Control Statements 


Control Statement Summary 
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The following figure contains the same information as Figure 1-8 in 
Chapter 1, “Introduction to EREP.” 




















CONTROL 

STATEMENTS WHAT THEY DO 

CONTROLLER | Tells EREP to combine the error records associated with | 
this particular control unit and its attached devices. 

DASDID Tells EREP that this is the configuration of the 33XX 
DASDs within each subsystem; identifies those that do 
not provide physical IDs for the System Exception 
report series. This control statement applies only to the 
System Exception Report series. 

ENDPARM Tells EREP that this is the end of the instream EREP 
parameters; the instream data that follows consists of 
EREP control statements. 

LIMIT Tells EREP not to produce any output for the System 
Exception reports when the number of errors is below 
the values specified here. This control statement applies 

SHARE 

Figure 12-6. Control Statements for EREP 


only to the System Exception Report series. 


Tells EREP to combine the records for these devices 
that are shared between systems. This control statement 
applies to all the reports that generate I/O device sum- 

maries. 













EREP Defaults 


| s Default Values and Actions for EREP Parameters 


When you do not include a parameter in the controls for an EREP run, EREP 
uses a default value for that parameter. Figure 12-7 on page 12-10 lists the 
default values EREP uses for each of the parameters. 


If you run EREP using no controls at all, the following happens: 


e EREP produces Detail Summary (and Data Reduction, if your installation 
includes 3370 DASD) reports of all the records on the ERDS. 


e The reports do not combine the records from shared I/O devices, nor do they 
identify the records as being from shared devices. 


e EREP writes the records to a history data set if one is available to receive 
them; if none is available, EREP issues an error message and the job or step 
abends. 
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EREP Defaults 








DATE All. EREP uses all the records in the input data set, regardless of when they 
were created. See the TRENDS parameter in Chapter 7, “EREP 
Parameters” for an exception to this rule. 


DEV All. EREP uses the records from all the valid IBM device types in your 
installation. 


DEVSER All. EREP uses records for the Threshold Summary regardless of the device 
serial numbers they contain. 


ERRORID All. EREP uses MCH and MVS software records regardless of the 
ERRORIDs they contain. 


HIST No. EREP does not expect to find the records on a history data set. 

LIA/LIBADR All. EREP uses 3705 and 3725 TP communication controller records regard- 
less of the line interface base address they contain. 

LINECT For MVS and VM, S50 lines per page; for VSE systems, the default is the 
number of lines per page set for SYSLST. 

MERGE No. EREP does not expect to merge the records from a history data set 
with those on the ERDS. 


All. EREP uses records from all S/370 processors, regardless of their model 
types. 


All. EREP uses all available records, regardless of whether they were 
recorded in 370 or 370-XA mode. 
l 















SHORT No. EREP does not print out short OBR records for Detail Edit reports. It 
does print them out for Detail Summaries, however. 

SYMCDE All. EREP uses all OBR records, regardless of the fault symptom codes they 
contain. 

TABSIZE For MVS and VM, EREP’s internal sort table is 24K bytes; for VSE 
systems, it is 4K bytes. 

TERMN All. EREP uses OBR records from TCAM- or VTAM-supported TP devices 
regardless of the terminal names they contain. 

TIME All. EREP uses all available records, regardless of the time they were 
created. 


TYPE All. EREP uses all types of records. 


VOLID All. EREP uses certain DASD and tape records regardless of the associated 
volume serial numbers. 
No. EREP does not clear the ERDS after completing the report. However, 
ZERO is tricky; see the ZERO parameter in Chapter 7, “EREP 
Parameters.” 


Figure 12-7. Default Values and Actions for EREP Parameters 
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DASD Capacities 





DASD Storage Capacities 


When allocating DASD storage for the work (DIRECTWK) data set, you need to 
know how many records a given device can hold. This table contains that infor- 
mation. 


See Data Management Services (MVS/370 and MVS/XA) to compute DASD 
track and cylinder capacities for blocked records. 


Average Average 
Records Records 


per per 
Track Cylinder 
Device Type > »4] [1,4] 


2314 580 

2319 

a SO 7 
7305 Mod. 2 ee ee 


Ee ee 


3330 
3330 Mod. II 
3340 
3344 





Figure 12-8. Storage Capacities of IBM DASD 


Notes: 


1. Average record size, except for MCH records, is 70 bytes plus the inter-record 
gap. 


2. Average MCH record size is 1600 bytes plus the inter-record gap. 


3. Fixed-block devices, with 512 bytes per block, can hold 7.3 average records per 
block. Each MCH record requires 3.125 blocks. 


4. Software records are much larger than average, because they include the 
SDWA. 
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TOURIST Output 


TOURIST Output: Messages and Controls 


Figure 8-4, in “DASDID Control Statement,” is one example of the TOURIST 
output. Figure 12-9 is the TOURIST output from an example of the prompting 
method of entering CPEREP operands (“Prompting Method” on page 9-10). It 
shows the TOURIST messages as they appear on the terminal screen. 


INPUT PARAMETER STRING PRINT=PS , DEV=(3420) 


PARAMETER OPTIONS VALID FOR THIS EXECUTION 
RECORD TYPES (MCH,CCH,OBR,SOFT,IPL,DDR,MIH,EOD,MDR), 
PRINT (EDIT,SUMMARY) , ACCUMULATE,LOGREC INPUT, 
DUMP SDR COUNTERS 
DATE/TIME RANGE - ALL 
TABLE SIZE - 024K, LINE COUNT - 050 
DEVICE ENTRIES 
DEVICE TYPES (OBR,MIH,DDR) -3420(8005) 
DEVICE TYPES (MDR) -3420(**) 
IFC1201 6 RECORDS THAT PASSED FILTERING 


OBR RECORDS REQUESTED BUT NOT FOUND 
SFT RECORDS REQUESTED BUT NOT FOUND 
IPL RECORDS REQUESTED BUT NOT FOUND 
DDR RECORDS REQUESTED BUT NOT FOUND 
MIH RECORDS REQUESTED BUT NOT FOUND 
EOD RECORDS REQUESTED BUT NOT FOUND 


NUMBER OF MCH TYPE OF RECORDS READ WAS 1 
NUMBER OF CCH TYPE OF RECORDS READ WAS 1 
NUMBER OF MDR TYPE OF RECORDS READ WAS 4 


Figure 12-9. TOURIST Output From a CPEREP Run 
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OBR Codes 


C Device Type Codes in the OBR Record 


At offset 52 (X’34’) in the long outboard (unit-check) record! is a four-byte field 
that contains a code for the device class and type of the failing device. Called 
“OBRCODE?” in this book, the field contains data gathered from different sources 
for different operating systems: 


e For VSE systems, only the first two bytes are significant. They are the con- 
tents of the fields at offset 4 and 5 in the physical unit block (PUB) for the 
device. The field names are PUBDEVTY and PUBOPTN. 


e For MVS systems, it is the second two bytes that are meaningful. They are 
bytes 18 and 19 (decimal) of the unit control block (UCB) for the device: 


— 18 (UCBTBYT3) is a code (bit mask) for the device class 
— 19 (UCBTBYT4) is a code for the device type. 


@ When VM writes an OBR record, it takes the device type code from either the 


PUB or the UCB, depending on which operating system is running in the 
virtual machine. 


C } In the short form of the record, the field is at offset 24 (X’18’). The code ts also in 
the CCH record, at offset 68 (X’44’), and in the SLH record, at offset 40 (X’28’). 


Chapter 12. Tables and Charts 12-13 


OBR Codes 


The following tables give the OBR device class/type codes (also called the OBR 
codes) from the UCB as they appear to EREP. The OBR codes are to the left of 
the equal signs. 


OBR Codes, Sorted by Code 


0801 
0802 
0803 
0804 
0805 
0806 
0807 
0808 
0809 
O80A 
O80B 
O80C 
O80D 
O80E 
0810 
0811 
0812 
0813 
0814 
0816 
0817 
0818 
0819 
O81A 
081B 
081C 
O81D 
O81E 
O81F 
0820 
0821 
0822 
0823 
0824 
0825 
0826 
0827 
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2540DD 
2540DD 
1442 
2501 
2520 
3505 
3525 
1403 
3211 
1443 
3203 
3525 
3262 
3800-1 
2671 
4245 
1012 
4248 
2947 
3890 
3886 
2495 
3895 
1285 
1287 
1288 
1419 
1419 
1275 
1052 
2150 
3210 
3215 
2956 
2956 
2956 
2956 


0828 
0829 
O82A 
082B 
O82C 
O82D 
O82E 
O82F 
0830 
0831 
0832 
0833 
0834 
0835 
0836 
0837 
0838 
0839 
O083D 
0840 
0841 
0842 
0844 
0846 
0847 
0848 
0849 
084C 
O84D 
084E 
0880 
0882 
O8A0 
1001 
1002 
1003 
1004 


2956 
1419 
1275 
1275 
1275 
1419 
1419 
2495 
3213 
1017 
1018 
3210 
3215 
1255 
1255 
1270 
1270 
2596 
7443 
3890 
3886 
3850 
3540 
2560 
3504 
5425 
3203 


1005 
1006 
1007 
1008 
1009 
100A 
100B 
100C 
100D 
100E 
100F 
1013 
1014 
2001 
2002 
2003 
2005 
2006 
2007 
2008 
2009 
200A 
200B 
200C 
200D 
200E 
201E 
202E 
2101 
2102 
2105 
2106 
2107 
4000 
4001 
4002 
4003 


2280 
2282 
3278 
3066 
327D 
3284 
3286 
3158 
3036 
3138 
3148 
5080 
BAOO 
2311 
2301 
2303 
2321 
2305 
2305 
2314 
3330 
3340 
3350 
3375 
3330 
3380 
3380 
3380 
3310 
3370 
3370 
9335 
9332 
7770 
2702 
2701 
2703 


4004 
4005 
4006 
4009 
400A 
4011 
4013 
4014 
4015 
4021 
4022 
4023 
4025 
4031 
4032 
4033 
4035 
4041 
4042 
4043 
4045 
4051 
4052 
4053 
4061 
4062 
4063 
4071 
4072 
4073 
4081 
4082 
4083 
4091 
4092 
4093 
40F1 


tou id t tft Ht tb dt dt dt ot dt ft tb ot db ud td tt te tt th tb dt te td te it te th te th th ot tt 


2955 
3705 
3705 
3704 
3968 
2702 
2703 
7772 
3705 
2702 
2701 
2703 
3705 
2702 
2701 
2703 
3705 
2702 
2701 
2703 
1060 
2702 
2701 
2703 
2702 
2701 
2703 
2702 
2701 
2703 
2702 
2701 
2703 
2702 
2701 
2703 
3791 


4100 
4201 
4202 
4203 
4204 
4205 
4206 
4207 
4208 
4209 
420A 
420B 
420F 
4210 
4211 
4212 
4213 
4214 
4214 
4215 
4216 
4217 
4218 
4219 
421A 
421B 
4420 
8001 
8003 
8004 
8005 
8006 
8007 
8008 
8009 
800A 
8080 


CTCA 
1030 
1050 
1060 
2740 
2740 
2741 
226T 
105T 
2760 
83B3 
115A 
1130 
2020 
2780 
2770 
2265 
2770 
2930 
2972 
327T 
2970 
3735 
3945 
2790 
3670 
3700 
2400 
3400 
3420 
3410 
8809 
3430 
7340 
9347 
3422 
3480 


J 


OBR Codes 


OBR Codes, Sorted by Device Type 


1014 = BAOO 1003 = 226D 4061 = 2702 0849 = 3203 4420 = 3700 
4100 = CTCA 4207 = 226T 4071 = 2702 O80B = 3203 4009 = 3704 
0812 = 1012 4213 = 2265 4081 = 2702 0822 = 3210 4005 = 3705 
1001 = 1015 1005 = 2280 4091 = 2702 0833 = 3210 4006 = 3705 
0831 = 1017 1006 = 2282 4003 = 2703 0809 = 3211 4015 = 3705 
0832 = 1018 2002 = 2301 4013 = 2703 0830 = 3213 4025 = 3705 
4201 = 1030 2003 = 2303 4023 = 2703 0823 = 3215 4035 = 3705 
1004 = 105D 2006 = 2305 4033 = 2703 0834 = 3215 4218 = 3735 
4208 = 105T 2007 = 2305 4043 = 2703 O80D = 3262 40F1 = 3791 
4202 = 1050 2001 = 2311 4053 = 2703 1009 = 327D O80E = 3800-1 
0820 = 1052 2008 = 2314 4063 = 2703 4216 = 327T O8A0 = 3800-3 
4045 = 1060 2005 = 2321 4073 = 2703 1007 = 3278 O84C = 3838 
4203 = 1060 8001 = 2400 4083 = 2703 100A = 3284 0882 = 3848 
420F = 1130 0818 = 2495 4093 = 2703 100B = 3286 0842 = 3850 
420B = 115A O82F = 2495 4204 = 2740 2101 = 3310 0817 = 3886 
0835 = 1255 0804 = 2501 4205 = 2740 2009 = 3330 0841 = 3886 
0836 = 1255 0805 = 2520 4206 = 2741 200D = 3330 0816 = 3890 
0837 = 1270 0801 = 2540DD 4209 = 2760 200A = 3340 0840 = 3890 
0838 = 1270 0802 = 2540DD 4212 = 2770 200B = 3350 0819 = 3895 
O81F = 1275 0846 = 2560 4214 = 2770 2102 = 3370 4219 = 3945 
O82A = 1275 0839 = 2596 4211 = 2780 2105 = 3370 400A = 3968 
082B = 1275 0810 = 2671 421A = 2790 200C = 3375 0811 = 4245 
O82C = 1275 4002 = 2701 4214 = 2930 200E = 3380 0813 = 4248 
O81A = 1285 4022 = 2701 0814 = 2947 201E = 3380 1013 = 5080 
081B = 1287 4032 = 2701 4004 = 2955 202E = 3380 084D = 5203 
081C = 1288 4042 = 2701 0824 = 2956 8003 = 3400 O84E = 5203 
0808 = 1403 4052 = 2701 0825 = 2956 8005 = 3410 0880 = 5424 
O81D = 1419 4062 = 2701 0826 = 2956 8004 = 3420 0848 = 5425 
O81E = 1419 4072 = 2701 0827 = 2956 800A = 3422 8008 = 7340 
O082D = 1419 4082 = 2701 0828 = 2956 8007 = 3430 083D = 7443 
O82E = 1419 4092 = 2701 4217 = 2970 8080 = 3480 4000 = 7770 
0829 = 1419 4001 = 2702 4215 = 2972 0847 = 3504 4014 = 7772 
0803 = 1442 4011 = 2702 100D = 3036 0806 = 3505 420A = 83B3 
O80A = 1443 4021 = 2702 1008 = 3066 0807 = 3525 8006 = 8809 
4210 = 2020 4031 = 2702 100E = 3138 O80C = 3525 2107 = 9332 
0821 = 2150 4041 = 2702 100F = 3148 0844 = 3540 2106 = 9335 
1002 = 2250 4051 = 2702 100C = 3158 421B = 3670 8009 = 9347 
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MDR Codes 


Device Type Codes in the MDR Record » 


The following tables give the MDR codes — one byte at offset 4 (X’4’) in the 
miscellaneous data record. The MDR codes are to the left of the equal signs. 


MDR Codes, Sorted by Code 


01 = 3330 12 = 2305 MOD 1 
O02 = 2305 MOD 2 13 = 3277 (NCP mode) 
03 = 3277 14 = 3380 

03 = 3286 15 = 3705 (NCP mode) 
03 = 3284 (non-NCP mode) 16 = 3310 

04 = 3211 17 = 3370 MOD 1 
O05 = (non-NCP mode) 18 = 3375 

06 = 3670 1A = 3370 MOD 2 
07 = 3168 1B = 3380 MOD E 
O08 = 2715 1C = 3380 MOD D 
09 = 3340 1D = 9335 

09 = 3344 1E = 9332 

OA = 3330 MOD 11 1F = 9347 

OB = 3277 20 = 3800 MOD 3,8 
OC = 3800 MOD 1 25 = 3725 

OD = 3895 40 = 8809 

OE = 3850 41 = 3480 

OF = IGAR Diskette FO = 2946 

10 = 3203 Fl = 2948 

10 = 3289 F3 = 2703 

11 = 


3350 


MDR Codes, Sorted by Device Type 


12 = 2305 MOD 1 17 = 3370 MOD 1 

O02 = 2305 MOD 2 1A = 3370 MOD 2 

F3 = 2703 18 = 3375 

08 = 2715 14 = 3380 

FO = 2946 1B = 3380 MOD E 

Fl = 2948 1c = 3380 MOD D 

07 = 3168 41 = 3480 

10 = 3203 06 = 3670 

04 = 3211 05 = 3705 (non-NCP mode) 
03 = 3277 15 = 3705 (NCP mode) 
OB = 3277 25 = 3725 

13 = 3277 (NCP mode) Oc = 3800 MOD 1 

03 = 3284 (non-NCP mode) 20 = 3800 MOD 3,8 
03 = 3286 OE = 3850 

10 = 3289 OD = 3895 

16 = 3310 40 = 8809 

O01 = 3330 1E = 9332 

OA = 3330 MOD 11 1D = 9335 

09 = 3340 1F = 9347 

09 = 3344 OF = IGAR Diskette 
11 = 3350 
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Part 4. Product-Dependent Information 


How to Use Part 4 


This part of the EREP User's Guide and Reference contains information about 
how EREP works with specific hardware and software products: 


@ devices 
@ processors 
@ control programs 


The information is arranged within IBM product groups, according to the specific 
product identifiers. 


For example, if you want to see the special considerations for EREP controls for 
34XX tape drives, you can find the information under 34XX in the subsection for 
magnetic tape devices. For specific information about an EREP report for a 3705 
communications controller, you would look under 3705 in the TP Devices sub- 
section. 


Part 4. Product-Dependent Information 


The product subsections are in the following order: } 


Processors (CPUs) 

Punched Tape Devices 

10. Teleprocessing Devices 

11. Other Devices 

12. System Control Programs (SCP) 


1. Card Readers and Punches 

2. Consoles and Displays 

3. Dhurect-Access Storage Devices (DASD) 
4. Diskette Devices 

5. Magnetic Tape Drives 

6. OCR/MICR Devices 

7. Printers 

8. 

9. 


Within each product group are the following kinds of information: 


Special considerations for EREP reports 

Sample reports, for some devices 

Special considerations for EREP controls (parameters and control statements) 
Other considerations, if any 

A list of the valid specifications for the relevant EREP parameters 

Where possible, a bibliography of other books that can be helpful. 


Note that this section of the book is somewhat dynamic; that is, it is designed so 
new pages can be added to the individual product subsections when new EREP 
device support is released. J 


This means that the product subsections might be superseded by newer informa- 
tion added under specific product numbers. Make sure the product-specific infor- 
mation is kept up to date, and look for new information under specific product 
numbers within each product subsection. 
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Chapter 13. Card Readers and Punches 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look for the specific number. 


Special Considerations for EREP Reports 
Useful reports for these devices are: 
SYSUM 
EVENT 
TRENDS 
PRINT =PT or PS with DEV=nnnn and TYPE=OH (OBR and MIH 


records) 


Care should be taken when requesting reports other than these as the results could 
be misleading. 


Some of the devices listed below may produce different record types. In that case, 


request that record type when requesting Detail Edit and Summary (PRINT) 
reports. 


Special Considerations for EREP Controls 


None. 
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These card devices are valid for DEV = 


1442 
2501 
2520 
2540 
2560 
2596 
3504 
3505 
3525 
5424 
5425 


card reader/punch 

card reader 

card reader/punch 

card reader/punch 
multi-function card machine 
card reader/punch 

card reader 

card reader 

card punch 

multi-function card machine 
multi-function card machine 


Chapter 14. Consoles and Displays 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 


Special Considerations for EREP Reports 
Useful reports for these devices are: 
SYSUM 
EVENT 
TRENDS 
PRINT=PT or PS with DEV=nnnn and TYPE=OTH (OBR, MDR and 
MIH records) 


Care should be taken when requesting reports other than these as the reSults could 
be misleading. 


Some of the devices listed below may produce different record types. In that case, 


request that record type when requesting Detail Edit and Summary (PRINT) 
reports. 


Special Considerations for EREP Controls 


None. 
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Consoles and Displays 


Devices Supported by EREP ) 
These console and display devices are valid for DEV= 


1015 display unit 

1052 console 

2020 console 

2150 console 

2250 display unit 

2260 display station 

2265 display station 

3036 console 

3066 console 

3138 console 

3148 console 

3158 console 

3168 console 

3210 console printer/keyboard 
3213 console printer 

3215 console printer/keyboard 
3277 display station (terminal) 
3278 display station (terminal) 
5080 graphics systems workstation 


Note: Although the 3279 display terminal is not valid for the DEV parameter, 
EREP does process its records — as 3277 records. ; 
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Chapter 15. Direct-Access Storage Devices (DASD) 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 


Special Considerations for EREP Reports 
e Useful reports for these devices are: 


SYSUM 

SYSEXN (33XX only) 

EVENT 

TRENDS 

PRINT=AL with DEV=nnnn and TYPE=DOTH (DDR, OBR, MDR 
and MIH records) 


Care should be taken when requesting reports other than these as the results 
could be misleading. 


Some of the devices listed below may produce different record types. In that 
case, request that record type when requesting Detail Edit and Summary 
(PRINT) reports. 


@ The 2305 is not supported by the System Exception report; EREP produces a 
Detail Summary for this device. Also, EREP produces a Data Reduction 
report for the 3370 only. To separate the reports for these devices and for 
dedicated DASD from the rest of the Detail PRINT output for I/O devices, 
run the following step before running any Detail PRINT reports for other I/O 
devices: 


PRINT=SD 


DEV=(2305,3370) 
TYPE=-OT 
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@ Detailed information about EREP Reports for these specific devices may be 
found in this chapter under: 


“33XX DASD” 

“3380 DASD” 

“3850 Mass Storage System” 
“9332 and 9335 DASD” 


EREP Controls 


@ Detailed information about EREP Controls for these specific devices may be 
found in this chapter under: 


“33XX DASD” 

“3380 DASD” 

“3850 Mass Storage System” 
“9332 and 9335 DASD” 


These direct-access storage devices are valid for DEV= 


2301 
2303 
2305 
2311 
2314 
2321 
23XX 
3310 
3330 
3340 
3344 
3350 
3370 
3375 
3380 
9332 
9335 
33XX 
3850 
3851 


Note: 


drum storage 
drum storage 
fixed head storage 
disk storage 

disk storage 

data cell drive 


disk storage 
disk storage 
disk storage facility 
disk storage 
disk storage 
direct access storage 
direct access storage 
direct access storage 
direct access storage 
direct access storage 


mass storage system 
mass storage facility 


23XX and 33XX are general device type designations that include families of 


direct-access storage devices. 


J 


C 33XX DASD 


33XX 


Special Considerations for EREP Reports 


System Exception Reports 


All Reports 


The 33XX subsystems are the only DASD subsystems included in the System 
Exception report series. The subsystems comprise: 


— 3310-3380 DASD drives 
— 9332 and 9335 DASD drives 
— 3830 and 3880 DASD control units 


Besides the other report types listed for DASD, SYSEXN is the most valuable 
for 33XX products. The System Exception series is meant to replace Detail 
Summaries for these devices. 


Virtual 33XX drives on 3850 mass storage systems are not included in the 
System Exception series. 


In the various summary reports of the System Exception series, 3375 and 3380 
errors can be reported differently from those of other DASD. Because the 
3375 and 3380 can have two controllers at the head of the string, the PH YS- 
ICAL ID field contains device or volume failures associated with the lowest 
CTLRID for the string on which the device resides. 


See “LIMIT Control Statement” in this subsection for more about DASD 
and the System Exception series. 


Some 33XX DASD identify themselves to EREP via physical IDs; the identi- 
fiers assigned to the storage control unit (SCU), the controller and the device 
when the device was installed. Other 33XX DASD are identified by the phys- 
ical and logical controller-unit addresses (CUAs). The sources of these dif- 
ferent identifiers are as follows: 


— The physical ID is in the sense records created for 3375 and 3380 devices 
and 3880 storage control units (storage directors). 


— The secondary control unit address (SCUA) is in the OBR or MDR 
record. It is the logical address from which the sense data was received. 


— The primary control unit address (PCUA) is the address of the physical 
device via the base (primary) channel. For 33XX devices, this is the posi- 
tion of the drive in its string. Note that the PCUA is also the physical 
address for a/] demountable DASD. 
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Some EREP reports show 33XX DASD by physical ID. In those that do not, 
the address shown is the PCUA. See the discussion of the DASDID control 
statement in Chapter 8 for more information about the physical ID. 


The only records used for 33XX DASD are OBR (long) and MDR records. 
OBR records indicate errors or single incidents. MDR records contain statis- 
tical data collected at the storage control unit for usage, errors, and overruns. 


With the advent of the System Exception report series, the combined 
OBR/MDR Detail Summary (PRINT = PS|SD|SU,TYPE = OT) has been 
eliminated, as have the MDR Detail Edit and Summary reports. The DASD 
summaries included in the System Exception series contain more information 
than was in the OBR/MDR summary, and present more meaningful usage 
data than appeared in the MDR Detail reports. 


In the System Summary and Trends reports, 33XX devices providing physical 
IDs are listed by those IDs only; CPU identifiers are omitted. 


Special Considerations for EREP Controls 


DASDID Control Statement 
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Devices having physical IDs do not require DASDID or SHARE statements. 


The reports that require SHARE statements for non-physical ID devices are 
System Summary, Trends, and Data Reduction (PRINT=DR or SD). 


The DASDID control statement applies only to the System Exception report 
series and, by implication, only to 33XX DASD. Because the syntax and values 
for the DASDID statement are the same for all device types, the description and 
explanation of the DASDID statement are in Chapter 8 under “DASDID 
Control Statement.” 


However, there are some notes about the DASDID statement that are product- 
specific: 


3880 and DASDID: The 3880 control unit supplies its own physical ID. If your 
installation includes 3880s, note those physical IDs before assigning any IDs to 
control units. The physical ID for each control unit should have been set with 
hardware switches at the time it was installed. 


Ss) 


C 


LIMIT Control Statement 


33XX 


The LIMIT control statement applies only to the System Exception report series. 
It works differently for each of the product groups it is used for; following is a 
description of the way you use it for 33XX DASD. It is not, however, valid for 
9332 and 9335 devices. 


The LIMIT statement has the following format for 33XX DASD: 


LIMIT dasd,keyword|,keyword] [,keyword] 
dasd can be one of the following generic product types: 


33 XX 
3310 
3330 
3340 
3350 
3370 
3375 
3380 
3830 
3880 


Note: 3340 includes 3344. 

33XX is the general device type designation for all the listed direct access devices 
and control units. When you code 33XX on a LIMIT statement, you are 
requesting that the limits apply to all devices of the general type. 


You can set minimum thresholds for eight different kinds of temporary errors or 
events recorded against DASD, using the LIMIT keyword values listed here. 


To Set Limits For: Use Keyword: 
Seek errors SKS = nnonn 

Read errors RD =nnnn 

Bus out parity errors B=nnnn 
Equipment checks EQUCHK = nnonn 
Check data C=nnon 

Invoked offsets I=nnnn 

Diskette checks D=nnnn 
Overruns OVRN = nnon 

All not otherwise specified ALL =nnnn 


“nnnn” can range from 1 to 9999; it requires no leading zeros. 
Be aware that: 


1. If you do not specify a number for “nnnn,” EREP uses a default value of 01, 
applying no limits to temporary errors on DASD. In this case, the line in the 
DASD Subsystem Exception report showing the CURRENT LIMITS contains 
00 for that keyword, and all errors of that type are included in the Subsystem 
Exception report. 
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2. When you set limits on temporary errors for DASD, EREP excludes from the 


Subsystem Exception report those errors that do not equal.or exceed the LIMIT 
statement values. For example, if you code 


LIMIT 3830,EQUCHK=5 ,OVRN=10 


the DASD Subsystem Exception report will show temporary equipment checks 
and overrun errors for a 3830 control unit only if there are 5 or more equipment 
checks and/or 10 or more overruns recorded against the device. 


Not all the keywords are valid for every product type. The table on page 15-7 
shows the valid error type keywords for each of the 33XX DASD products. 


When you specify 33XX or ALL on a LIMIT statement, EREP uses only the 
valid keywords for each device type included. 


Use of the LIMIT control statement is invalid for 9332 and 9335 devices. 


EREP ignores the ALL values on any LIMIT statements that follow a 33XX 
statement on which ALL is specified. For example: 


LIMIT 3330,SKS=5,ALL=10 
LIMIT 33XX,ALL=15 
LIMIT 3340,RD=5,ALL=20 


EREP limits the 3330 using the values in the 3330 statement, and limits all 
other DASD using the value in the 33XX statement. It ignores the “ALL” 
value in the 3340 statement, because the 33XX statement takes precedence. If 
you need the “ALL” value for 3340s, put that LIMIT statement before the one 
for 33XX, as follows: 


LIMIT 3330,SKS=5,ALL=10 
LIMIT 3340,RD=5,ALL=20 
LIMIT 33XX,ALL=15 


Now EREP limits the 3330 using the values in the 3330 statement, the 3340 
using the values in the 3340 statement, and all other DASD using the value in 
the 33XX statement. 


7. Only one LIMIT statement is allowed for the general device class of 33XX. 


33XX 


DEVICE Equipment Diskette 
TYPE : Checks: Check: 
EQUCHK D 





Bibliography 
e IBM Disk Storage Management Guide — Error Handling, GA26-1672, con- 


tains much valuable information about 33XX DASD, including detailed infor- 
mation about the System Exception reports. 
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3380 DASD 


“3380” represents a family of direct-access storage devices that comprises several 
models of the 3380 type. 


See the “Bibliography” on page 15-10 for the titles of hardware manuals con- 
taining detailed information about the various models of 3380. 


Special Considerations for EREP Reports 


System Exception Report 


Other Reports 


In the DASD System Exception reports that show FAILURE AFFECTs or 
PROBABLE FAILING UNITs, the 3380 family of devices has an additional 
category — MULTIPLE. This describes errors that may affect more than one 
device but are not controller failures. 


The reports in which you can see MULTIPLE used are: 
System Error Summary Part 2 
Subsystem Exception Report 
Symptom Code Summary 
String Summary 
In the System Exception report series, 3380: models are identified as follows: 


Identifier 3380 Models 


3380-DE AD4, AE4, BD4, BE4 


In the device-dependent section of the Detail Edit (PRINT) report, the 3380 
models are identified as they are for the System Exception Report series (see 
above). 


Special Considerations for EREP Controls 
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3380 is a 33XX device; see “33XX DASD” on page 15-3 for more informa- 
tion. 


C 


Other Considerations 


3380 


MDR codes (one byte at offset 4) for the 3380 are: 


MDR Code 


X’14’ 


X’1B’ 


X’1C’ 


Description 

3380 models AA4, A04, B04, AD4, and BD4. 

— Sense byte 4, bit 1 is 0 for models AA4, A04, and B04. 

— Sense byte 4, bit 1 is 1 for models AD4 and BD4 operating 
as a 3380 model AA4, A04, or B04. 

3380 models AE4 and BE4. 


3380 models AD4 and BD4 with full command support pro- 
vided by the system. 


OBR codes (two bytes at offset X’36’)! are: 


OBR Device 
Class| Type 


X’200E’ 


X’201E’ 


X’202E’ 


Description 

3380 models AA4, A04, B04, AD4, and BD4. 

— Sense byte 4, bit 1 is 0 for models AA4, A04, and B04. 

— Sense byte 4, bit 1 is 1 for models AD4 and BD4 operating 
as a 3380 model AA4, A04, or B04. 


3380 models AD4 and BD4 with full command support pro- 
vided by the system. 


3380 models AE4 and BE4 


The field, named OBRCODE, really starts at offset X’34’, in the long form of the 
OBR record. The two bytes at offset X’34’ are PUB bytes 4 and 5, used by VSE as 
device class and type. The two bytes listed here are bytes 18 and 19 from the MVS 


UCB. 
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Storage capacities of the various models compare as follows: 


Model Factor 


A04 = Ix 
B04 1x 
AD4 1x 
BD4 1x 
AE4 2x 
BE4 2x 


where “x” is the storage capacity of a 3380 Model AA4. 


IBM 3380 Direct Access Storage Description and Users Guide, GA26-1664, 
provides a complete description of the various models of the 3380 direct 
access storage characteristics, features and capabilities. In addition, the con- 
figuration and attachment options are described. 


IBM 3880 Storage Control Models 1, 2, 3 and 4 Description Manual, 
GA26-1661, contains commands, controls, sense descriptions, and recovery 
actions for all drives connected to the 3880 storage controller. 


3850 


3850 Mass Storage System 


Special Considerations for EREP Reports 


The System Exception reports do not include virtual 33XX DASD connected to a 
3850 mass storage system. 


Special Considerations for EREP Controls 


None. 


Bibliography 


e OS/VS Mass Storage System (MSS) System Data Analyzer, GC35-0027, 
describes the ISDASDAO support for the IBM 3850 Mass Storage System. 
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9332/9335 


9332 and 9335 DASD 


These devices are members of the “33XX” family of direct access storage devices. 


See the Bibliography for the titles of hardware manuals containing detailed infor- 
mation about these devices. 


Special Considerations for EREP Reports 


System Exception Report 


Detail Edit Report 


As members of the “33XX” family, the 9332 and 9335 devices are included in 
the System Exception report series. 


For both the 9332 and 9335 devices, seek information is displayed when 
appropriate. 


Special Considerations for EREP Controls 


Other Considerations 
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9332 and 9335 are 33XX devices; see “33XX DASD” on page 15-3 for more 
information. 


Use of the LIMIT control statement for 9332 and 9335 is invalid. 


MDR codes (one byte at offset 4) are: 
MDR Code Meaning 

X’1D’ 9335 DASD 

X’1E’ 9332 DASD 


OBR codes (two bytes at offset X36’)! are: 


OBR Device 

Class/Type Meaning 
X’2106’ 9335 DASD 
X’2107’ 9332 DASD 


C 


Bibliography 


9332/9335 


IBM 9332 Disk Unit Models 200/400 Analyzing Problems, SA21-9837. 
IBM 9332 Disk Unit Models 200/400 Reference Code Guide, SA21-9836. 
IBM 9332 Disk Unit Models 200/400 Service Guide, SY31-9026. 


IBM 9335 Direct-Access Storage Subsystem Guide to Unit Reference Codes, 
SY33-0143. 


IBM 9335 Direct-Access Storage Subsystem Service Guide, SY33-0113. 
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Chapter 16. Diskette Unit 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 
Special Considerations for EREP Reports 
Useful reports for these devices are: 
SYSUM 
EVENT 
TRENDS 
PRINT =PT or PS with DEV =nnnn and TYPE=OH (OBR and MIH 
records) 
Care should be taken when requesting reports other than these as the results could 
be misleading. 


Special Considerations for EREP Controls 


None. 


Devices Supported by EREP 
This diskette unit is valid for DEV= 


3540 diskette I/O unit 
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Chapter 17. Magnetic Tape Drives 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 


Special Considerations for EREP Reports 
e Useful reports for these devices are: 


SYSUM 

SYSEXN (34XX only) 

EVENT 

TRENDS 

THRESHOLD (3410, 3420 and 8809 only) 

PRINT =PT or PS with DEV=nnnn and TYPE= DOTH (DDR, OBR, 
MDR and MIH records). 


Care should be taken when requesting reports other than these as the results 
could be misleading. 


Some of the devices listed below may produce different record types. In that 
case, request that record type when requesting Detail Edit and Summary 
(PRINT) reports. 


e The System Exception report series includes records from the following mag- 
netic tape devices: 


3410 
3420 
3430 
3480 
9347 


See the subsection on 34XX Tape Devices for more information. 


e The Threshold Summary report for tape subsystems includes records from the 
following magnetic tape devices: 


3410 


3420 
8809 
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Tape Devices 


The fields in the Volume Statistics section of the Threshold Summary are used 
differently by different device types: 


— 3410/3420 OBR records do not use the the SIO WRTS field, and use the 
IOS RDS field for TOTAL IOS. 


— 8809 MDR and OBR records do not use the following fields at all: 


— MDR: 


TU SERIAL 
PERM RDS 
PERM WRTS 
PROGRAM ID 
MOD # 
DENSITY 
HDR SER 


— OBR: 


TU SERIAL 
TEMP RDS 
TEMP WRTS 
RETRY 
ERASE GAP 
MOD # 
DENSITY 
HDR SER 
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It is unneccessary to use the TYPE parameter for the Threshold summary, as 
the THRESHOLD report parameter itself forces the selection of 3410, 3420, 
and 8809 OBR (TYPE=O) records. You can, however, use the DEV param- 
eter to select records from one or two of the device types instead of all three. 
You can also use the DEVSER or VOLID parameter for the Threshold 
Summary to select records according to the device serial number or volume 
serial number they contain. 


You code the LIMIT control statement differently depending on which tape 
device you are dealing with. See “34XX Tape Devices” on page 17-4 and 
“9347 Magnetic Tape Drive” on page 17-23 for details. 


Tape Devices 


{ Devices Supported by EREP 
These magnetic tape storage devices are valid for DEV = 


2400 magnetic tape drive 
3400 magnetic tape drive 
3410 magnetic tape drive 
3420 magnetic tape drive 
3430 tape unit 

3480 magnetic tape subsystem 
34XX general device class 
7340 hypertape drive 

8809 magnetic tape drive 
9347 magnetic tape drive 


Note: 34XX is a general device type designation that includes 3410, 3420, 3430, 
and 3480. 
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34XX 


34XX Tape Devices 


Special Considerations for 


System Exception Report 


Special Considerations for 


LIMIT Control Statement 


EREP Reports 


Besides the other report types listed for tape, SYSEXN is the most valuable 
for 34XX products. The System Exception series is meant to replace the 
Threshold summary for these devices. 


The System Exception report covers the 34XX family of tape devices, where 
34XX includes 3410, 3420, 3430, and 3480. 


The SYSEXN (System Exception report series) report parameter produces dif- 
ferent sets of reports for different 34XX tape devices. If you have all of the 
34XX tape devices, you get one set of exception reports and summaries for 
3410/3420 products, another for 3430, and another for 3480. 


If your tape subsystem is a large one, you can greatly improve performance 
when running the System Exception report by moving the tape records to a 
history data set and then running SYSEXN against those records. To move 
the records, run EREP using PRINT = NO, DEV =(34XX) and ACC=Y. 
Make sure you have included a job control statement or FILEDEF for the 
output data set. 


EREP Controls 


The LIMIT control statement applies only to the System Exception report series. 
The limiting action of this EREP control works differently for tape devices than it 
does for DASD or processors. You need two sets of keyword parameters for each 
device type; and, for 34XX devices, you must specify which tape density the limits 
apply to. 


Note: Because tape density is not a factor for the 3480 tape subsystem, the 3480 
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LIMIT statement differs significantly from what follows. See “3480 Flex- 
ible Media Tape Subsystem” on page 17-11 for details. 


34XX 


The LIMIT statement has the following format for 34XX tape devices other than 


3480: 


LIMIT tape,xxbpi=nnn(ct)[,xybpi=nnn(ct) ] 


tape 


Xx and xy 


bpi 


ct 


is one of the device type numbers listed under “Valid Keywords 
and Values for the LIMIT Statement.” 


are pairs of initials indicating the types of temporary errors to be 
limited. See “Valid Keywords and Values for the LIMIT 
Statement.” 


is the density (bits per inch) at which the device is operating. The 
possible values for bpi are 1600 and 6250. 


Is a three-digit decimal value representing the number of mega- 
bytes of data processed between errors (MBYTES/ERROR). 


Is a decimal value from 1 to 99 representing the number of errors 
encountered before the device or volume appears on the Subsystem 
Exception report. 


Valid Keywords and Values for the LIMIT Statement 


tape can be one of the following: 


34XX 


3410 
3420 
3430 


34XX is the general device type designation that, in this case, includes 3410, 3420, 
and 3430. When you code 34XX on a LIMIT statement, you are requesting that 
the limits apply to the reports for all of these devices. 


The valid LIMIT keywords for 34XX tape drives are: 


e 1600 BPI Temporary Errors 


To Set Limits For: Use Keyword: 
Hardware read HR1600 = nnn(ct) 
Hardware write HW 1600 = nnn(ct) 
Volume read VR1600 = nnn(ct) 
Volume write VW 1600 = nnn(ct) 


@ 6250 BPI Temporary Errors 


To Set Limits For: Use Keyword: 
Hardware read HR6250 = nnn(ct) 
Hardware write HW6250 = nnn(ct) 
Volume read VR6250 = nnn(ct) 
Volume write VW6250 = nnn(ct) 
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34XX 
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EREP uses both the nnn (MBYTES/ERROR) and ct (total errors) values to estab- J 
lish thresholds for temporary errors. If the number of errors recorded against the 

device or volume is greater than or equal to the count (ct) value, AND the 

average number of megabytes of data processed between errors is equal to or less 

than the error frequency (nnn) value, then the device or volume will appear on the 

Subsystem Exception report. 


Points to Remember: 


e To cover all the possible sources of errors for a 34XX device, you must code 
LIMIT statements for both hardware and volume read and write errors. 


e If you do not code LIMIT statements for a tape device or volume, the Sub- 
system Exception report includes only the permanent errors recorded against 
that device or volume. However, all temporary errors appear in the Tempo- 
rary Error Summary. 


e To force EREP to show all the temporary errors on the Subsystem Exception 
report, use 999(1) for the nnn(ct) variables on the LIMIT statement. 


@ You should specify all LIMIT values. Results are unpredictable if any values 
are omitted, or if a value is coded as 0. 


e The density of 6250 BPI applies only to 3420 and 3430 drives. If coded ona 
LIMIT statement for 34XX, it is ignored for 3410 devices. 


e Ifa tape drive is operating at a density other than 1600 or 6250 BPI, EREP J 
uses the LIMIT values you specify for 1600 BPI. 


@ Only one LIMIT statement is allowed for the general 34XX type. 


@e You may not continue a LIMIT statement from one line to the next. Gener- 
ally, you should use separate LIMIT statements to establish hardware and 
volume limits for a device. If the device operates at both 1600 and 6250 BPI, 
you must use separate statements. However, if only one tape density is 
involved, you can combine all four keywords on the same LIMIT statement. 
For example, you might want to see only some of the temporary errors for 
your 3410 and 3420 drives, operating at 1600 BPI density, as follows: 


— Hardware 


Read: 1 or more errors, at 25 megabytes/error 
Write: 15 or more errors, at 10 megabytes/error 


— Volume 


Read: 1 or more errors, at 25 megabytes/error 
Write: 15S or more errors, at 10 megabytes/error 


c 


Using the DEVSER Parameter 


Bibliography 


34XX 


To set these limits, you could code the following LIMIT statements: 


LIMIT 3410,HR1600=025(1) ,HW1600=010(15) , VR1600=025 (1) , VW1600=010(15) 
LIMIT 3420,HR1600=025(1) ,HW1600=010(15) , VR1600=025 (1) , VW1600=010(15) 


Because the limiting values and density are the same, these two statements 
could be combined into a single 34XX LIMIT statement: 


LIMIT 34XX,HR1600=025 (1) ,HW1600=010(15) , VR1600=025(1) , VW1600=010(15) 


When your 34XX devices are operating at different densities, and you want to 
use 34XX to designate them rather than individual device type numbers, you 
cannot fit all four sets of keywords on the single 34XX LIMIT statement 
allowed. 


In this case, if you specify only the volume or hardware values for both densi- 
ties on a single 34XX LIMIT statement, EREP applies those values to which- 
ever kinds of errors you have not specified. For example: 


LIMIT 34XX,VR1600=010(1) , VW1600=010(1) , VR6250=020(1) , VW6250=020(1) 


EREP applies the values specified here for volume reads and writes to hard- 
ware reads and writes for all your 34XX devices. (When EREP checks the 
LIMIT statement syntax, it fills in any blanks it finds with the corresponding 
values supplied elsewhere on the same statement. This is why results can be 
unpredictable when you do not code all the values on a LIMIT statement, or 
code a value as 0.) 


The DEVSER selection parameter applies only to the Threshold Summary, and, 
by implication, only to 3410, 3420 and 8809 device types. Furthermore, the 
DEVSER parameter is valid only with TYPE =O, because only tape OBR records 
contain device serial numbers. 


The following publications provide more detailed information about the 3410 and 
3420 Tape Subsystems. 


IBM 3410 Theory and Maintenance, SY34-0031, part of the Field Engineering 
Maintenance Library, contains examples of Detail reports for these devices. 


IBM 3410/3411 Tape Subsystem, SV31-0714, includes status and sense byte 
information. 


IBM 34XX Subsystem Operator's Guide, GA32-0066. 
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3422 


3422 Tape Subsystem S) 


Special Considerations for EREP Reports 


In addition to the other reports in the System Exception series, the 3422 tape sub- 
system has a summary of the temporary errors recorded while the device was in 
forced-logging mode. 


The Forced Log Error Summary report for the 3422 is almost identical to the 
report example for the 3430; Figure 17-1 on page 17-9. Aside from some minor 
variation in the interpretation of the sense information and some column 
headings, the reports for the 3422 are the same as the reports for other 34XX tape 
devices. 


Special Considerations for EREP Controls 


Bibliography 
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The 3422 is included as one of the 34XX tape devices for purposes of the System 
Exception report series and, on the DEV selection parameter, for other reports. 


See “LIMIT Control Statement” on page 17-4 for details about the LIMIT state- 
ment. 


J 


The following publications provide more detailed information about the 3422 
Tape Subsystem. 


@e IBM 3422 Magnetic Tape Subsystem Reference Manual, GA32-0089. 


@ IBM 3422 Maintenance Information Manual, SY32-5058. 


3430 Tape Device 


Special Considerations for EREP Reports 


3430 


3430 TAPE FORCED 


DEVICE ADDRESS - 


LOAD 
CHECK 


3430 TAPE FORCED 


In addition to the other reports in the System Exception series, the 3430 magnetic 
tape device has a summary of the temporary errors recorded while the device was 
in forced-logging mode. The report first presents the totals of each type of failure 
by device address or number (CUA/DEVNO), and then lists each record in the 
order of its device address or number. 


REPORT DATE 145 83 
' PERIOD FROM 240 81 


LOG ERROR SUMMARY 


TO 240 82 
O8F3 
4 5 | Gi El 9 | 
NON READ WRITE LAST TIME 
REP ERROR ERROR OTHER FCS PTR VOLID YYDDD HHMMSS 
| 
6 15 9 VOLOO1 82169 113020 
2 172 VOLO001 82169 113020 
0 8 0 fe) 
LOG ERROR DETAIL 
F P 
R/W --CCW--- SCSW64-95 -------- SENSE==4-=-2—= s T 
TIME VOLID E/U CMD FLG CNT /CSW32-63 0 2 4 6 8 CR 
113020 VOLO0O1 02 32002222 08002222 0800 0000 0000 1590 20 15 9 
113020 VOL001 02 32002222 08002222 0800 0000 0000 1590 20 15 9 
113020 VOLO0O1 02 32002222 08002222 0800 0000 0000 1590 20 15 9 
113020 VOL0O1 02 32002222 08002222 0800 0000 0000 1590 20 15 9 
113020 VOLOO1 02 32002222 08002222 0800 0000 0000 1590 20 15 9 
113020 VOLO0O1 02 32002222 08002222 0800 0000 0000 1590 20 15 9 
113020 VOLO0O1 02 32002222 08002222 0800 0000 0000 7720 20 17 2 
113020 VOLO01 02 32002222 08002222 0800 0000 0000 7720 20 17 2 


Cc 
CHP DEVNO P 
-ID /CUA U DTE 
O8F3 A 169 
O8F3 A 169 
O8F3 A 169 
O8F3 A 169 
O8F3 A 169 
O8F3 A 169 
O8F3 A 169 
O8F3 A 169 
CPU MODEL 
A 3033 
B 0168 
Cc 3081XA 


Figure 17-1. 


Forced Log Error Summary for 3430 


SERIAL NUMBER 
088888 
090018 
220014 
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3430 


Figure 17-1 on page 17-9 is an example of the Forced Log Error Summary for a 
3430 device. 


Notes: 

I. DEVICE ADDRESS. Failing CUA or device number. 

2. LOAD CHECK. Total number of load checks for this fault symptom code. 

3. NON REP. Total number of non-reportable failures for this fault symptom 
code. 

4. READ ERROR. Total number of read errors for this fault symptom code. 

5. WRITE ERROR. Total number of write errors for this fault symptom code. 

6. OTHER. Total number of other failures for this fault symptom code. 

7. FSC. Fault symptom code, from the sense bytes. 

8. PTR. Part of the fault symptom code. 

9. VOLID. The volume identifier from the OBR record. 


10. LAST TIME. Time of the most recent failure. 


11. DETAIL. Same as in the 34XX Tape Permanent Error Summary. 


Special Considerations for EREP Controls 


Bibliography 


The 3430 is included as one of the 34XX tape devices for purposes of the 
System Exception report series and, on the DEV selection parameter, for 
other reports. 


See “LIMIT Control Statement” on page 17-4 for details about the LIMIT 
statement and the 3430. 


The following publications provide more detailed information about the 3430 
Tape Subsystem. 
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IBM 3430 Magnetic Tape Subsystem: Description, GA32-0076, includes status 
and sense byte data as part of the general problem determination and error 
recovery information. 


3430 Magnetic Tape Subsystem Maintenance Information, SY32-5053, part of 
the IBM Maintenance Library, includes examples of the EREP reports. 


J 


Cc 3480 Flexible Media Tape Subsystem 


| 


Special Considerations for EREP Reports 


System Exception Report 


If your installation’s configuration includes a 3480 Flexible Media (tape) Sub- 
system, the device’s records will be included automatically when you run the 
System Exception series. 


EREP produces a separate set of System Exception reports for the 3480 Sub- 
system. Most of the reports do not differ significantly from the examples shown 
in Part 1 of this book; the titles, and some headings, are specific to the 3480. The 
figures on the following pages are examples of the System Exception report 
output for the 3480. ! 


CODING NOTES 


e Normally the System Exception report series includes the 34XX tape drives 
(3410, 3420, and 3430), and 3480 Subsystems. To limit the report to 3480s, 
run EREP once, requesting no report and the accumulation of selected 3480 
records to an output history data set: 


//STEP1 EXEC PGM=IFCEREP1,PARM=('PRINT=NO', 
'DEV=(3480)','TYPE=OT', 'ACC=Y') 


Then run EREP again, requesting the System Exception report series and 
using the history data set created in STEP] as input: 


//STEP2 EXEC PGM=IFCEREP1,PARM=SYSEXN,HIST 


The result should be a System Exception series using only the records gener- 
ated by the 3480 Subsystem. 


Note: You must request both OBR (type O) and MDR (type T) records in 
the initial selection process; EREP uses both for the 3480 System 
Exception report. 


If you already have a jobstream that generates a System Exception series for 
your 3420s, change the T YPE parameter from TYPE=O to TYPE=OT to 
make it work for 3480s. 


| 
@ EREP uses 3480 MDR records only for the System Exception report series; 
you cannot get Detail Edit reports of those records. 
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3480 


SUBSYSTEM EXCEPTION 


REPORT DATE 207 85 


3480 PERIOD FROM 004 83 
TO 019 83 
TEMP WRT(CT) TEMP RD(CT) 
CURRENT LIMITS HARDWARE NONE (_ ) NONE (_ ) 
MBYTES/ERR VOLUME NONE (_ ) NONE (_ ) 
VOLUME DEVNO EQU ---MB/ERR PERM--- ---MB/ERR TEMP--- BUS OVR TOTAL-MBYTES HDR 
EXCEPTION SERIAL /CUA CPU CHK READ(CT) WRITE(CT) WRITE(CT) READ(CT) OUT RUN READ WRITE SER 
HARDWARE 
PERMANENT ERROR 
01BX B 1 -- ( 0) 3841( 3) 60( 192) -- ( 0) 0 0 8206 11523 
01B2 B 1 eS, O} see “Q) 49( 98) -- ( 0) 0 0 4059 4898 
02B2 B 0 -- ( 0) 875( 1) 19( 44) -- ( 0) 0 860 0 875 
01B4 Cc 0 ee 20): sees 0) 18( 80) -- ( 0) 0 0 873 1489 
VOLUME OR CREATING DRIVE 
PERMANENT READ OR WRITE ERRORS ON MORE THAN ONE DRIVE 
TAPEO1 B 1 == °':0) 68( 1) O( 82) -- ( 0) 0 0 0 68 0000 
L00100 B 0 == (0) 55( 2) 18 ( 6) -- ( 0) 0 0) 0 110 0000 
TOTAL NUMBER OF DRIVES FAILING LIMITS 3 ( 16%) TOTAL NUMBER OF VOLUMES USED = 23 
PASSING LIMITS 16 ( 84%) TOTAL NUMBER OF VOLUMES LISTED = 2 


CPU MODEL SERIAL NUMBER 
A 3081 020344 
B 4341 015760 


Figure 17-2. 3480 Subsystem Exception Report 


3480 Subsystem Exception Report 


This report, Figure 17-2, is essentially the same as the other tape Subsystem 
Exception reports, except that the errors are not grouped by tape density; density 
is not relevant to the 3480. 


Notes: 


1. Drives that “fail” the limits appear on the report; those “passing” the limits do 


not. 
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The “limits” are LIMIT values. 


"LI saideyy 


SaALIG adel onouseP] 


CI-LI 


‘) 


"€-L1 aang 


AIBVUIWINS 101 JUDUBULIOG O8PC 


CHP DEVNO 
-~ID /CUA 


¥¥** DRIVE 


x VOLUME 
1B1 


C R 
P W 
U DTE TIME VOLID CE CMD FLG 
HHH 
B 018 112929 SSAG23 0 
B 006 131152 ASAG65 W 
B 007 111537 TAPEO1 E 
B 007 115041 0 
B 007 115219 0 
B 007 115248 0 


FAILED MORE THAN ONE DRIVE Xx 
01 


-B_012 164444 L00100 W 


xe OPERATOR OR OPERATIONAL *%x 


18B B 018 105558 7 0 
18B) = B 018 110320 SSAG03 O 
1B4¢ B 018 110214 0 
MXN OTHER RX 
1B4 B 018 113811 SSAG23 0 
2B2 B O12 101901 0 
x*N CONTROL UNIT xx 
2B2 B 006 131342 ASAG65 O 
2B2 B 007 111537 ASAG65 0 
CPU MODEL SERIAL NUMBER 
A 3081 020344 
B 4341 015760 


3480 PERMANENT “ RECOVERED ERROR SUMMARY 


SENSE BYTES---> 
CCW SCSW64-95 


00 
01 
07 
02 


02 
02 


07 
02 


07 


02 
C7 


64 


20 
04 


20 


20 
00 


oo 


/CSW32-63 


26000000 


06004434 
0E0C0000 
0E&400050 
0E400050 
0£400050 


 060020BC 


02000000 
02000001 


02000050 


06000050 
02000000 


06000050 
26000000 


Cc 


TO 


0 2 


612E 


8825 
8822 
892E 
892E 
892E 


6025 


4248 
4240 


783B 
783B 


4248 603B 


0084 0602 


REPORT DATE 207 85 
PERIOD FROM 004 83 


019 83 


0000 0020 


0002 7E20 
0000 0020 
0000 0020 
0000 0020 
0000 0020 


0017 7320 


0000 0020 
0000 0420 


0000 0020 


3000 0002 


ERR1 ERR2 ERRL HW 
#3900 PERMANENT ERRORS 3% 


EFOO 7161 


0000 7401 
0000 8E05 
EFOO 7161 
EFOO 7161 
EFOO 7161 


0024 740D 


0008 8202 
0008 8202 


0004 8202 


OEF8 0715 


4040 8000 0000 0020 0000 0000 
HHH RECOVERED ERRORS x XHHX 


0044 8848 0002 7C€20 0000 3F135 
4040 8048 0000 0020 0081 6EED 


7161 
7401 
8E05 
7161 


7161 
7161 


740D 


0000 


7709 
0000 


0000 
0000 


7157 


7401 
8E05 
7161 
7161 
7161 


740D D824 


0000 
0000 


0000 
0000 


0000 0000 


3000 
0000 


3709 
0000 


0000 
0000 


0000 
0000 


0001 


ooo 
ooo 
ooo 
eoo 


0000 


0000 


0000 
0000 


0000 
0000 


2 
0 


2 
2 


---DR---- 


ERR1 


0264 
0000 
0000 
0264 


0264 
0264 


0000 


OOFF 
0000 


OOFF 


1026 
0000 


0000 
0000 


ERR2 


0264 
0000 
0000 
0264 


0264 
0264 


0000 


0000 
0000 


0000 


4026 
0000 


F604 
F084 
F684 
F084 


F084 
F084 


F604 


F004 
F604 


F004 


4F60 
F004 


F084 
F684 


C780 
E780 
E780 
E780 


E780 
E780 


E780 


E780 
E780 
E780 


4E78 
C780 


C780 
C780 


cu 
SER# 


0000 


0000 
0000 
0000 
0000 
0000 


0000 
0000 


QW 


0000 


0000 
0000 
0000 
0000 


0000 


0000 


0000 
0000 


0000 
0000 


O8re 


3480 


3480 Permanent Error Summary 


This report shows the sense data in permanent-error OBR records. Sense bytes 

10 - 17 and 20 - 24 are presented as error codes for use as indexes into the mainte- 
nance manual. The first group are associated with control-unit-detected errors; 
the second, with drive errors. 


Notes: 

I. Channet-path IDs appear for 370-XA mode records. 

2. R/{W/E: Kinds of commands associated with errors — read, write, equipment 
and operator. 

3. Command code and flag byte from the CCW. 

4. Error codes, to be used as indexes into the maintenance manual; associated with 
the control unit (CU) and device (DR). 

5. Serial number of the control unit to which the device is attached. 
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Cc 3480 FORCED LOG REPORT 


CHP DEVNO 
~ID /CUA 


O1B1 


.CPU MODEL 
A 4341 


Figure 17-4. 


DYE TIME 
012 164444 
007 111523 
007 112209 
O12 164219 


018 112929 


P>>>>rrr>r>r » FY PrP FF CTO 
o 
t-] 
a 


t— J 
Qo 
~d 
ome mo fmt pee p> me be Pe 


VOLID 

LO01L00 
TAPEO) 
TAPEOL 
L00100 
SSAG23 


ASAGG5 


TAPEO1 


SERIAL NUMBER 
015760 


Oo0o0oomook o £EEO E£ mExR 


SENSE B 
cCcw 


CMD 
01 


FLG 
64 


YTES---> 
SCSW64-95 
/CSW32-63 


060020BC 


02000000 
O6007FF8 
06004434 


26000000 


06004434 
06000050 
26000000 
0E000000 
02400050 
0£400050 
0E€400050 
02000000 


3480 Forced Log Summary 


3480 Forced Log Summary 


REPORT DATE 214 


PERIOD FROM 006 
TO 


85 
3 
3 


1 1 1 1 2 2 2 2 2 

2 4 6 & 0 2 4 6 - 
==<-f§J—-=-—-----— ---p -e2— 

ERR2 ERRL HW ERR1 ERR2 SERS 


ow 


This report contains data only when the device has been running in forced-logging 
mode, which produces OBR records for temporary errors. The report summarizes 
those temporary-error OBR records using the same format and headings as in the 
Permanent Error Summary. 


Note: See the Permanent Error Summary for information about field names, etc. 
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3480 TEMPORARY ERROR SUMMARY 


DEVNO DRIVE 


/CUA ID 
181 01171 
182 01172 
188 061178 
188 01168 
189 01179 
18A OLIG6A 
18B 00000 
1A7 01187 
1A9 01189 
LAA 0118A 
1AB 01188 
1AD 0118D 
BL 01171 
I1B2 01162 
1B3. 01173 
1B4¢ 01174 
1B8 01168 
2B1 01161 
2B2 00000 

TOTALS: 
AVERAGE 
AVERAGE 
AVERAGE 
AVERAGE 
AVERAGE 
AVERAGE 
AVERAGE 
AVERAGE 
AVERAGE 


cP 
A 
B 


TO 9019 83% 
P ---WRITE---- ---- READ---- TOTAL-MBYTES --PROCESSED-- --- 
U MOUNTS MB/ERR ERRCT MB/ERR ERRCT READ WRITE READ WRITE MB/COR. 
A 1 -- 0 -- 0 0 126 -- 3840 
A 1 -- 0 -- 0 0 67  -- 2048 
A 11 43 6 -- 0 6 263 212992 19456 
B 200 -- 0 -- 0 0 8 -- 7424 
A 8 A 0 -- 0 199 196 307200 13824 
B 1 -- 0 -- 0 0 16384 -- 
B 8 -- 0 -- 0 197 402 118784 16896 
B 0 -- 0 -- 0 0 0 -- -- 
B 0 -- 0 -- 0 0 0 -- -- 
B 0 -- 0 -- 0 0 0 -- -- 
B 0 -- 0 -- 0 0 0 -- -- 
B 0 -- 0 -- 0 0 0  -- -- 
B 49 329014 0 3153 4606 13640K 514304 
B 73 49 98 0 4059 4898 13984K 451840 
B 20 -- 0 -- 0 121 311 1597K 109824 
B 6 18 80 -- 0 873 1489 1008K 82688 
B 20 -- 0 -- 0 0 219 -- 12288 
B 17 69 17 -- 0 0 1187 -- 66816 
B 21 19 44 = 0 0 875 -- 48896 
202 259 0 8608 14647 30884K 1350K 

MEGABYTES/TEMPORARY READ ERROR = x Bon 
MEGABYTES/TEMPORARY WRITE ERROR = 56 
MEGABYTES/RECOVERED ERROR = 11627 
MEGABYTES/PERMANENT READ ERROR = x 
MEGABYTES/PERMANENT WRITE ERROR = 3661 
MEGABYTES/PERMANENT ERROR 8 = 5813 
MEGABYTES/PERMANENT HARDWARE ERROR = = 1937 
MEGABYTES/PERMANENT VOLUME ERROR = 5813 
MEGABYTES/PERMANENT OTHER ERROR = x 

TOTAL MEGABYTES PROCESSED = 23255 


U MODEL 
3081 
4341 


SERIAL NUMBER 
a 9 


20344 
015760 


REPORT DATE 207 85 
PERIOD FROM 004 83 


Ec = COMPARABLE TO 3420 AVERAGE MB/PERM. ERROR RATE 


W 
ECC MB/COR 


-- 0 
-- 0 
0 15 


0 
12 16 


28980 


READ WRITE 

RITE---- RECVY ERASE 
ECC ACTS GAPS 

15 8 0 0 
22 3 0 0 
0 513 0 6 
== 0 0 0 
7 25 0 0 
== 0 0 0 
36 11 0 0 
= 0 0 0 
ae 0 0 0 
s 0 0 0 
ae 0 0 0 
== 0 0 0 
0 12920 0 26 

1 4084 0 233 

7 43 0 0 

0 18393 0 86 

3 73 0 0 

2 402 0 18 

3 290 0 73 
36765 0 442 


ERR 


m=OmmROWLOQOooor Ononr& 


16 


CU 
EQU 
CHK 


-_ moooooooooeooooooooo 


= THERE WERE NO ERRORS LOGGED FOR CALCULATION 





SPD 
VAR 


O8PhE 


C 3480 Temporary Error Summary 


This report totals the temporary errors recorded in MDR records against each 
device and presents selected Statistical data from the records. In addition, EREP 
calculates the average frequency of the various kinds of temporary errors for this 
report. 


Note: All temporary errors appear on the report, without regard for any limits set 


via LIMIT statements. 


The 3480 Volume Statistics Summary, not shown here, contains the same kind of 
statistical data as in the Temporary Error Summary, but for both temporary 
errors that exceeded the LIMIT values and permanent (OBR) errors. 


Notes: 

1. Four-digit control-unit serial number plus the one-digit address position of the 
drive. 

2. Totals and frequencies of errors. 

3. See the 3480 Subsystem Description, GA32-0042, for the definition of blocks. 

4. 


Sense data from the MDR record; the correction/recovery actions recorded. 
Data used in calculating the averages at 7. 

Applies to figures presented at 7. 

Translation of block information. 


Megabytes processed per permanent error — can be used to compare the effi- 
ciency of two different types of tape devices. 


Processors, identified from filtered data or SHARE statements. XA following 
the model number indicates that the processor was running in 370-XA mode. 
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3480 ERROR CODE SUMMARY REPORT 


REPORT DATE 207 85 
PERIOD FROM 004 83 


TO 019 83 
Co CCG 
DEVNO.P (H.U UO S=S<=Ss-s-=> CUHSsessSesses ese DR====-= wake DATE/TIME **** 
/CUA U RROD ERRI F ERR2 ERRL HW ERRI1 F ERR2 OCCURRENCES *** LAST ENTRY **** 
01B1 B C00 740D 24 740D 740D D824 0000 00 0000 1 012/83 16:44:44:35 
01B2 B CO 1 8E05 00 8E05 8E05 0000 0000 00 0000 1 007/83 11:15:37:57 
0O1B2 B C00 A130 12 A130 A130 D58A 0000 00 0000 4 012/83 16:41:15:86 
0O1B2 B COO 740F 24 740F 740F D824 0000 00 0000 1 012/83 16:42:19:90 
01B2 B C01 7401 00 7401 7401 DO02 0000 00 0000 1 007/83 11:22:09:09 
01B4 B COO 7161 00 7161 7157 D6CC 0264 00 0264 1 018/83 11:29:29:49 
01B4 B cOO 0715 F8 7709 3709 3000 1026 00 4026 1 018/83 11:38:11:11 
O2B2 B DO 1 7161 00 7161 7161 0000 0264 00 0264 3. 007/83 11:52:48:34 
02B2 B DO 0 0000 00 0000 0000 0000 0000 00 0000 1 012/83 10:19:01:68 
0O2B2 B DO 1 7401 00 7401 7401 D002 0000 00 0000 1 006/83 13:11:52:81 
O2B2 B DO 1 8E05 00 8E£05 8E05 0000 0000 00 0000 1 007/83 11:15:37:81 
02B2 B DO 1 3F13 00 0000 0000 0000 0000 00 0000 1 006/83 13:13:42:27 
02B2 B DOO 6EED 81 0000 0000 0000 0000 00 0000 1 007/83 11:15:37:17 
CPU MODEL SERIAL NUMBER 
A 3081 020344 
B 4341 015760 


Figure 17-6. Error Code Summary for 3480 


3480 Error Code Summary Report 
This report summarizes the error codes recorded by the 3480 subsystem for its 
various field-replaceable units (FRUs). It lists the errors by device address or 
number and by the error code, a set of numbers that identifies the particular field- 
replaceable unit involved. The report notes the number of occurrences for each 
error code, and the time of occurrence. 
Notes: 
1. Channel-adapter interface. 
2. The path through the control unit to the device. 


3. Error codes from OBR sense bytes. 


4. Control-unit-detected errors. “F’ is a flag byte that modifies the ERR1 indi- 
cator. “ERRL” is the last control unit error code. 


5.  Control-unit-detected hardware errors. 
6. Drive-detected errors. 


7. Again, “F’ indicates a flag byte used in data analysis. 
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Cc 3480 DEVNO/CUA Statistics Summary 


One of these reports is generated for each device (device number or CUA) that 
appears as a hardware exception on the Tape Subsystem Exception report. The 
report presents the DEVNO/CUA’s temporary errors that failed the limits set in 
LIMIT control statements. The errors appear by volume serial number in the 
order (date and time) in which they occurred. 


I 
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3480 DEVNO/CUA STATISTICS SUMMARY FOR-02B2 REPORT DATE 207 85 
PERIOD FROM 004 83 


TO 019 83 
DEVICES FAILING LIMITS OR PERMANENT ERRORS 


CURRENT LIMITS TEMP WRTICCT) TEMP RD(CT) 
MBYTES/ERR HARDWARE NONE ¢ ) NONE ( ) 


ER|F |_MB PROC_ DATA ERR 
TIME |VOLID |PA[M RD RD 
T JWRT RD WRT FWD BKWD 


DTE TEMPORARY |GAPS 


WRITE READ 


DATA CHK 
WRT RD 


RTY | DET 














006 092221 SSAGOO 2B 21 
006 092241 2B 21 
006 100627 SSAGOO 2B 21 
006 100724 SSAGOO 2B 21 


01800 SSAGOO 2B 21 
02115 SSAGOO 2B 21 
02435 SSAGOO 2B 21 
05756 SSAGOO 2B 21 
aeons SSAGOO 2B 21 
1 
1 


2858 SSAGOO 2B 21 
4346 SSAGOO 2B 21 


006 123258 SSAGOO 2B 21 


006 131152 ASAG65 25 20 
006 131341 ASAG65 2B 21 
006 131343 ASAG65 2B 21 
006 142557 SSAG21 2B 21 
006 143021 ASAG65 2B 21 
006 143606 SSAG23 2B 21 2 
006 144315 ASAG61 2B 21 2 
006 145422 SSAG25 2B 21 2 
007 111652 TAPEO1 2B 21 


N 


roy 
ea 
~d 
roy 
~d 
— 
o 
—% 
=" 

eT ee 
COOWUPE ER O0O0 COOK KOR RR RP ror Ror 


- 
@egooefooaoecoecoeo0 oood0co0cooececo0oeoeoeooece 


eoqooqaooeaqaeaco0 ec00ce00coceooeoeooeoeo 
eoeooceco0coeceeoco scecaeececeaecaecococecoceceoeod 
eeceocoeqeocooeo oeceococoodeocoeooeoeoeo 
eoeoceoco0eesos eqceqeoeocococoeoeeooeoeeoa 
e0re0cemoocooeo eaeococecocoececeo0cceo0oocecoea 
tt 
& ot 
( | 
( | 
oa 
e0o0omoo0oo0o0o0oen scsoqoo0oceaeoococoeoeocoeooose 
eqecocoecoaoooeoeo oeeeecoceoeoceeeceo0o0oeceo 


CPU MODEL SERIAL NUMBER 
A 3081 020344 


B 4341 015760 


_MB/ ERROR eaPs|mny [DET 


eoraqaqoooo°o°o eEaqooe0oeoeoeo0eocoocooo 


—_CU_ 


leeu 
CHKS 


aeooqooooo°o°9o]oe ooorocooqoooqce@eoooco 


SPD VAR 


ISD Var 


RD WRT 





—BLK PROC 
WRT READ 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
12 12 
3080 12 
197 12 
3080 12 
3080 12 
3080 12 
12 12 
12 12 
12 12 


_BLK COR_ 
WRT READ 
0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

0 0 

5 0 

2 0 
19 e 
40 0 
55 0 
67 0 
102 0 
0 0 

0 0 

0 @ 


_HDR_ 
SER 


| 


--- o-oo o-oo. o-oo 0 ee 


O8rt 


C 


c 


3480 


Special Considerations for EREP Controls 


@ 3480 is a valid value for the DEV selection parameter. 


@ 3480 is also included in 34XX. That is, when you code DEV=34XX, EREP 
selects records from 3410, 3420, 3430, and 3480 tape drives.! 


LIMIT Control Statement for 3480 


ment is different for the 3480 than for other supported tape devices. The format 
of the 3480 LIMIT statement is: 


Because tape density is not : factor for the 3480 device, the LIMIT control state- 


LIMIT 3480,xx3480=nnn (ct) ,xy3480=nnn(ct) 


XX and xy are pairs of initials indicating the types of temporary errors that 
are to be limited. The possible values for xx and xy are listed 
under the valid LIMIT keywords for 3480. 


nnn Is a 3-digit decimal value representing the number of megabytes of 
data processed between errors (MBYTES/ERROR). 


ct Is a decimal value from 1 to 99 representing the number of errors 
encountered before the device or volume appears on the Subsystem 
Exception report. 


Valid LIMIT Keywords for 3480 


The LIMIT control statement uses unique keywords for the 3480. The valid 
keywords are: 





To Set Limits For: Use Keyword: 
Hardware read | HR3480 = nnn(ct) 
Hardware write | HW3480 = nnn(ct) 
Volume read | VR3480 = nnn(ct) 
Volume write | VW3480 = nnn(ct) 


| 
EREP uses both the nnn (MBYTES/ERROR) and ct (total errors) values to estab- 
lish thresholds for temporary errors. If the number of errors recorded against the 
device or volume is greater than or equal to the count (ct) value, AND the 
average number of megabytes of data processed between errors is equal to or less 
than the error frequency (nnn) value, then the device or volume will appear on the 
3480 Subsystem Exception report. 


l This depends on the report requested. See “34XX Tape Devices” on page 17-4 for 
details. | 


| 
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Points to Remember: 


Other Considerations 


Bibliography 


If you do not code LIMIT statements for a 3480 device or volume, the Sub- 
system Exception report includes only the permanent errors recorded against 
that device or volume. However, all temporary errors appear in the 3480 
Temporary Error Summary. 


To force EREP to show all the temporary errors on the Subsystem Exception 
report, use 999(1) for the nnn(ct) variables on the LIMIT statement. 


You should code all LIMIT keyword values. Results are unpredictable if any 
values are omitted, or if a value is coded as 0. 


You may not continue a LIMIT statement from one line to the next. Gener- 
ally, you should use separate LIMIT statements to establish hardware and 
volume limits for the device. 


The MDR device code for the 3480 Tape Subsystem is X’41’. This code is 
one of the bit masks that can appear in Byte | of the record-dependent 
switches in the header portion of the MDR record. 


The OBR code (UCB device class and type: MVS only) for the 3480 is 
X’8080’. See “Device Type Codes in the OBR Record” on page 12-13 for 
more information. 


The following publications have more information about 3480 error recording, 
and detailed examples of EREP reports for the device. 
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3480 Subsystem Description, GA32-0042, contains status and sense byte data, 
as part of the problem determination and error recovery information. 


3480 Subsystem Maintenance Information, in 4 volumes. EREP report exam- 
ples are in Volume 1, SY32-5048. 


9347 


C 


Special Considerations for EREP Reports 


9347 Magnetic Tape Drive 


Useful reports for these devices are: 





SYSUM 

TRENDS 

EVENT 

PRINT=PT or PS” 


SYSEXN | 


Care should be taken when requesting reports other than these as the results could 


be misleading. 


Subsystem Exception Report 


Special Considerations 


Bibliography 





Aside from minor variations in headings the subsystem exception reports are 
similar to those described for the 3480 (See “3480 Subsystem Exception Report” 
on page 17-12) with these exceptions: 





Use of the LIMIT control statement is invalid for the 9347. Therefore, the 
current limits are not reported. 








The count and frequency of permanent and temporary errors is not recorded. 
Therefore, the MB/ERR counts are not reported. 





| 
There is no Forced Log Summary. 


for EREP Controls — 


Use of the LIMIT control statement is invalid for 9347 devices. 


The following publications provide more detailed information about 9347 Mag- 


netic Tape Drive. 





IBM 9347 Magnetic Tape Drive Setting Up, SA21-9528. 
IBM 9347 Magnetic Tape Drive Operating, SA21-9529. 


IBM 9347 Magnetic Tape Drive Reference Code Guide, SA21-9838. 





IBM 9347 Magnetic Tape Drive Analyzing Problems, SA21-98339. 


IBM 9347 Magnetic Tape Drive Service Guide, SY31-9030. 


| 


| 
} 
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Chapter 18. OCR/MICR devices 





The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 


Special Considerations for EREP reports 


Useful reports for these devices are: 


SYSUM 
EVENT 
TRENDS 


PRINT=PT or PS with 


MIH records) 


DEV =nnnn and TYPE=OTH (OBR, MDR and 


Care should be taken when requesting reports other than these as the results could 
be misleading. 


Some of the devices listed below may produce different record types. In that case, 


request that record type whe 


reports. 


Special Considerations for EREP Controls 


None. 


Devices Supported by EREP 


n requesting Detail Edit and Summary (PRINT) 


These OCR/MICR devices are valid for DEV = 


1255 
1270 
1275 
1285 
1287 
1288 
1419 
3886 
3890 
3895 


MICR reader 


optical character reader 
optical reader/sorter — 


optical reader 
optical reader/sorter 
optical page reader 
MICR reader/sorter 


optical character reader 


document processor 


document reader/sorter 
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Chapter 19. Printers 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 


Special Considerations for EREP reports 
e Useful reports for these devices are: 
SYSUM 
EVENT 
TRENDS 
PRINT =PT or PS with DEV=nnnn and TYPE=OTH (OBR, MDR 
and MIH records). 


Care should be taken when requesting reports other than these as the results 
could be misleading. 


Some of the devices listed below may produce different record types. In that 
case, request that record type when requesting Detail Edit and Summary 
(PRINT) reports. 


e EREP produces a combined OBR/MDR Summary for the 3800 Printing Sub- 
system when you request Detail Summaries for that product. 


Special Considerations for EREP Controls 


None. 
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Printers 


Devices Supported by EREP 
These printers are valid for DEV= 2 


1053 __ printer 

1403 printer 

1443 printer 

2245 printer 

3203 printer 

3211 printer 

3262 printer 

3284 printer 

3286 printer 

3287 printer 

3288 printer 

3289 line printer 

32XX 

3800 printing subsystem 
3820 page printer 

38XX 

4245 printer. 

4248 printer 

5080 graphics systems workstation 
5203 printer 


Note: 32XX and 38XX are general device type designations that include families of 


IBM printers. ) 


Bibliography 
The following publications provide more information about IBM printers: 
@ 3800 Printing Subsystem Operator's Guide, GA26-1634. 


@ 3800-3 Operator's Guide, GA32-0068. 
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3820 


3820 Printer 


The general information about EREP for IBM printers also applies to the 3820 
page printer. | 

Special Considerations for EREP Reports 
EREP includes records from the 3820 printer with the other OBR records 


produced by the 3791 cluster controller. All 3820 records and incidents are identi- 
fied by “3791.” 


Special Considerations for EREP Controls 
3820 is a valid number for the EREP DEV (device type) selection parameter. 


However, that number does not appear in EREP reports. Instead, the records are 
listed under “3791.” 


Bibliography 
The following publication provides more information about the 3820 page printer. 


@ 3820 Maintenance Library, Volume 2, Section 6-800. 
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4248 


4248 Printer 


The general information about EREP for IBM printers also applies to the 4248 
line printer. 


Special Considerations for EREP Controls 
4248 is a valid number for the EREP DEV (device type) selection parameter. 


If the device is running in 3211 mode, code 3211 on the DEV parameter. 


Bibliography 
The following publication provides more information about the 4248 printer. 


@ 4248 Printer Model I Description, GA24-3927. 
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Chapter 20. Processors (CPUs) 


The information in this subsection could be changed or superseded by newer 
information added under specific product types. If you are interested in a new 
product or machine number, look under that number. 


Special Considerations for EREP Reports 
e Useful reports for these devices are: 


SYSUM 

TRENDS 

EVENT | 

SYSEXN (not for all types) 

PRINT = PT or PS MOD = nnnn or CPU = nnnnnn.nnnn and 
TYPE =MC (MCH and CCH/SLH records) 


Care should be taken when requesting reports other than these as the results 
could be misleading. 


e The System Exception report applies to only some processors. See the indi- 
vidual machine types for more information. 


e The 308X processors are not supported by the System Exception report series 
as error sources. Instead, these processors have, as part of their error 
recovery systems, service action points that appear on the service support 
console to indicate which part of the processor complex is experiencing 
machine-check or channel-check problems. 


e EREP lumps SLH and CRW records under a single processor ID, even for a 
3084 running in partitioned mode. 


e@ Whether or not the Software Recovery Status bits are valid depends upon the 
operating system and the processor. The information in these bits applies 
only to the 3090 processor. See “3090 Processor” on page 20-8 for more 
information. | 
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Processors 


Special Considerations for EREP Controls 


LIMIT Control Statement 


The LIMIT control statement applies only to the System Exception report series. 
It works differently for each of the product groups it is used for; following is a 
description of the way you use it for the processor and channel Subsystem Excep- 


tion reports. 


The LIMIT statement has the following format for processors: 


LIMIT cpu,keyword=nn[,cpu,keyword=nn] 


cpu is one of the following S/370 processors and its associated channels: 


0158 
0168 
3031 
3032 
3033 


keyword is one of the keywords representing the various types of soft machine 
checks or channel checks covered by the System Exception report 
series. See “Valid LIMIT Keywords for Processors/Channels.” 


nn is a two-digit decimal value ranging from 1-99. It indicates the 
minimum number of errors that must be recorded during a 60-minute 
“reference period” for the processor or channel to be included on the 
Subsystem Exception report. The reference period begins when an 
error of the type specified in the LIMIT statement is recorded. 


Valid LIMIT Keywords for Processors/Channels 
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The valid LIMIT keywords for processors and channels are: 


e Processor 
To Set Limits For: 
External damage 
Hardware instruction retry 
Buffer error 

e Channel 
To Set Limtts For: 
Channel error 
Storage error 


Director error 
Control Unit error 


Use Keyword: 


EXTD=nn 
HIRS=nn 
BUFE=nn 


Use Keyword: 


CHAN =nn 
STOR=nn 
DRCT=nn 
CTRL=nn 


Processors 


Points to Remember: 


e If you do not supply a number for “nn,” EREP applies a default value of 01, 
meaning that all soft errors recorded on processors or channels are included 
in the printed report. In this case, the line in the report showing the 
CURRENT LIMITS contains 00 for that keyword. 


@e The LIMIT keywords for processors and channels apply to soft errors only. 
They represent the types of errors listed under SOFT MACHINE CHECK in 
the Processor Subsystem Exception report, and as the three SERVICE 
LEVEL INDICATOR categories in the Channel Subsystem Exception report. 
See the Subsystem Exception report examples in Chapter 2, “EREP 
Reports.” 


e The STOR and DRCT keywords for channel errors are mutually exclusive: 
STOR applies to the 0158 and 0168 processors, and DRCT applies to the 
303X processors. 


e You can set limits for processor and channel errors on separate LIMIT state- 
ments or on the same statement. For example: 


LIMIT 3033,EXTD=05,HIRS=05,BUFE=03 
LIMIT 3033,CHAN=01,DRCT=04,CTRL=08 


or 


LIMIT 3033,CHAN=01,DRCT=04,CTRL=08 , EXTD=05,HIRS=05, BUFE=03 


e You may not continue a LIMIT statement from one line to the next. You 
may, however, code as many separate LIMIT statements as you need. 


Processors Supported by EREP 


These processor machine types are valid for CPU= and MOD= 


0115 0125 0135 0138 0145 0148 0155 0158 
0165 0168 3031 3032 3033 3052 3062 3081 
3083 3084 3090 4321 4331 4341 4361 4381 
9081 9083 9373 9375 9377 
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303X Processors 


303X Processors 


Special Considerations for EREP Reports 


The 303X processors are among those included in the System Exception report 
series. 


Special Considerations for EREP Controls 


LIMIT Control Statement 


Other Considerations 


See the discussion of the LIMIT statement under Chapter 20, “Processors 
(CPUs)” for details about the 303X processors. 


The only valid values for the CHAN LIMIT statement keyword for a 303X 
processor are CHAN =00 and CHAN=01. If you code any other value for 
CHAN, EREP processes it as if it were CHAN = Ol. 


Frame Records for Machine and Channel Checks 
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The machine-check and channel-check records generated by 303X processors must 
be translated before EREP can interpret them for its reports. The records are 
translated using frames provided by the processors’ Service Record File devices. 


Sets of frames are recorded in a reserved area of the ERDS by all three operating 
systems for EREP’s reference. 


e VSE systems use the SET RF =CREATE IPL command to initialize 
SYSREC and write the frame records. 


e MVS systems use the IFCDIPOO service aid program to initialize 
SYS1.LOGREC and write the frame records. 


e After system initialization, VM uses the CLEARF operand of the CPEREP 
command to reinitialize the error-recording area and update the frame 
records. 


The frame records cannot be removed from the ERDS by the ZERO parameter; 
you must reinitialize the data set in order to erase or update them. See 
Chapter 24, “System Control Programs (SCPs).” 


For detailed information about the 303X frame records, see the maintenance doc- 
umentation for the 3031, 3032, and 3033 processors, and for the 7443 Service 
Record File. 


J 


303X Processors 


frames; if you copy the ERDS repeatedly, you are copying the same frames 


( Note: When you copy the ERDS to a history data set, you copy every set of 


over and over again. 


SET RF =CREATE under VSE 


The SET RF =CREATE command creates and initializes or reinitializes the VSE 
recorder file. If there are frames present, the initialization routines write them on 
SYSREC and note their presence in the SYSREC header record. 


When the frames must be updated, you must re-IPL the system and re-issue the 
SET RF=CREATE command; the initialization routines recreate the SYSREC 
header, update the frame records, and set the rest of the file to hexadecimal zeros. 


IFCDIP00 under MVS 


The IFCDIP00 service aid program sets up LOGREC initially and also reinitial- 
izes it. See SPL: SYS].LOGREC for more information. 


CLEARF under VM 


In order to update 303X frame records in the VM error-recording area, you must 
use the CLEARF operand with CPEREP. See “Managing Error Data” on 
page 3-1 for general information about clearing the error-recording area. 


There are some usage notes specific to the CLEARF operand: 


You cannot use CLEARF with any other operands. Therefore, you should 
make sure you have captured pertinent error area information before issuing 
CPEREP with CLEARF. 


The service support console must be in SRF mode. 


Before using CLEARF, you must access the service record file device for the 
processor. The method differs depending on the processor model: 


— For the 3031 and 3033: 


Enable the I/O interface for the service support console. 
Activate the Cl frame on the service support console. 

Select the SRF mode - A2. 

VARY the SRF online. 

Attach the SRF to the console (user class F) running EREP. 


aN a ae a 


— For the 3032: 


1. Enable the I/O interface for the SRF from which you want to read a 
frame. 

2. Go to frame 31. 

3. Leave the displayed frame untouched. 

4. Run CPEREP. 
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303X Processors 


e You must use CLEARF to update the frame records in the error-recording ) 
area after the installation of engineering changes to the processor(s) and chan- 
nels. 


Bibliography 


The following publications contain more detailed information about specific 
processors. 


@ IBM 3031 Maintenance Guide, SY25-0517. 
@ IBM 3032 Maintenance Guide, SY25-0518. 


@ IBM 3033 Maintenance Guide, SY25-0519. 
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3090 Processor 


3090 Processor 


Special Considerations for EREP Reports 
The 3090 processor is not included in the System Exception report series. Report 


requests are the same as those listed under “Special Considerations for EREP 
Reports” on page 20-1. 


Special Considerations for EREP Controls 


3090 is a valid model number for the CPU and MOD selection parameters. 


Other Considerations 


@ Depending on the mode it is running in, the 3090 can generate the following 
record types: 


— MCH 
— CCH (370 mode) 
— SLH/CRW (370-XA mode) 

@ The Software Recovery Status bits may appear in the Detail Edit report for 
the 3090. The validity of the information depends upon the operating system 
you are running under. 

Following are excerpts from the Detail Edit reports for MCH, CCH and SLH 
records showing the Software Recovery Status information. For examples of 
the entire reports see Chapter 2, “EREP Reports”: 

CCH Figure 2-23 on page 2-64 

MCH Figure 2-29 on page 2-69 


SLH Figure 2-42 on page 2-83 
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UNIT STATUS 
ATTENTION 
STATUS MODIFIER 
CONTROL UNIT END 
BUSY 
CHANNEL END 
DEVICE END 
UNIT CHECK 
UNIT EXCEPTION 


OOO O90 00 8 


SOFTWARE RECOVERY STATUS 


HARD FAIL 
DEGRADE FAIL 
SOFT FAIL 
PASSED 


OOF Oo 





CHANNEL STATUS 
PROGRAM CONTROLLED INTERRUPT 
INCORRECT LENGTH 
PROGRAM CHECK 
PROTECTION CHECK 
CHANNEL DATA CHECK 
CHANNEL CONTROL CHECK 
INTERFACE CONTROL CHECK 
CHAINING CHECK 


Figure 20-1. CCH Detail Edit Report with Software Recovery Status 


FAILING STORAGE ADDRESS: 
REGION CODE: 
EXTERNAL DAMAGE CODE: 


SOFTWARE RECOVERY STATUS 
HARD FAIL 
DEGRADE FAIL 
SOFT FAIL 
PASSED 


NOT APPLICABLE 
NOT APPLICABLE 
NOT APPLICABLE 


Oro Oo 





ooro0oece0d oO 


NOTE: THE PRODUCT FUNCTIONAL CHARACTERISTICS PUBLICATION DESCRIBES THE MACHINE CHECK INTERRUPT CODE SUPPORT. 


Figure 20-2. MCH Detail Edit Report with Software Recovery Status 
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3090 Processor 





---UNIT STATUS---- SUB-CHANNEL STATUS 9 rrr rrrrtt rrr ttt tre r eterna SCSW (PLAGS=<=s625 <s= = 9s=-9e-==-" 
FLAG 0 FLAG 1 FLAG 2 

ATTENTION QO PGM-CTLD IRPT O CCW FORMAT O RESERVED OQ SUBCHANNEL ACTIV 0 

STATUS MODIFIER O INCORRECT LENGTH 0 PRE-FETCH CCW O SSCH FUNCTION 1 DEVICE ACTIVE 0 

CONTROL UNIT END 0 PROGRAM CHECK O INIT STATUS O HSCH FUNCTION O SUSPENDED 0 

BUSY O PROTECTION CHECK 0 ADDR LIMIT O CSCH FUNCTION QO ALERT STATUS 1 

CHANNEL END QO CHAN DATA CHECK OQ SUPP SUSPEND INT 0 RESUME PENDING QO INTERMED STATUS 0 

DEVICE END O CHAN CTL CHECK 1 ZERO COND CODE QO START PENDING 1 PRIMARY STATUS i 

UNIT CHECK O I/F CTL CHECK O EXTENDED CONTROL 1 HALT PENDING QO SECONDARY STATUS 1 

UNIT EXCEPTION OQ CHAINING CHECK O PATH NOT OPER 0 CLEAR PENDING OQ STATUS PENDING 1 

----SOFTWARE RECOVERY STATUS----- 

HARD FAIL a8 1 

DEGRADE FAIL 0 2 

SOFT FAIL 0 3 

PASSED 0 4 


Figure 20-3. SLH Detail Edit Report with Software Recovery Status 
Notes: 
1. Operation not recovered. 
2. Operation recovered but hardware resource lost. 
3. Operation recovered and no resource lost. 


4. WM passed error to guest 


Bibliography 


e IBM 3090 Processor Complex Functional Characteristics is the general-purpose 
manual for customers. _ 


@e IBM 3090 Processor Complex Introduction and Locations, System Volume 
AO1, includes a description of the rest of the 3090 library for IBM Customer 
Engineers. 
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3090 Vector Facility 


3090 Vector Facility 2 


Special Considerations 


Special Considerations 


Other Considerations 


Bibliography 


for EREP Reports 


The Vector Facility is considered part of a 3090 processor complex rather than a 
stand-alone product. Tc see records associated with the Vector Facility, request 
the various reports listed under “Special Considerations for EREP Reports” on 
page 20-1. The machine-check (MCH) Detail PRINT reports include informa- 
tion specific to the product. 


for EREP Controls 


You cannot specify the Vector Facility on any of the EREP selection parameters. 
If it is installed as part of your 3090 processor complex, it is automatically 
included in MCH records. 


The MCH records associated with the Vector Facility show two new bit settings 
in the machine-check interrupt code (MCIC) portion: 


e Offset 48 (X’30’), Bit 6, if on, indicates a Vector Facility failure. 
e Offset 48 (X’30’), Bit 13, if on, indicates that the Vector Facility is the source ) 
of the record. 


EREP identifies and formats these bits under ADDITIONAL MCIC FLAGS in 
the model-dependent part of the MCH Detail Edit report. 


e IBM 3090 Processor Complex Functional Characteristics 1s the general-purpose 
manual for customers. 


e IBM 3090 Processor Complex Introduction and Locations, System Volume 
AO1, includes a description of the rest of the 3090 library for IBM Customer 
Engineers. 
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9373/9375/9377 





9373, 9375 and 9377 Processors 


Special Considerations for EREP Reports 
The 9373, 9375 and 9377 processors are included in the System Exception Report 


Series. The reports are similar to those described in Part 1 of this book; the 
titles, and some headings, are specific to these processors. 


Special Considerations for EREP Controls 


9373, 9375 and 9377 are valid model numbers for the CPU and MOD selection 
parameters. 


Other Considerations 


The 9373, 9375 and 9377 processors run in 370 mode only. They can generate the 
following record types: 


e MCH 
e CCH 
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Chapter 21. Punched Tape Devices 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 


Special Considerations for EREP Reports 
Useful reports for these devices are: 
SYSUM 
TRENDS 
EVENT 
PRINT =PT or PS with DEV =nnnn and TYPE=OH (OBR and MIH 


records). 


Care should be taken when requesting reports other than these as the results could 
be misleading. 


Special Considerations for EREP Controls 


None. 


Devices Supported by EREP 
These punched tape devices are valid for DEV= 
1012 paper tape punch 
1017 paper tape reader 


1018 paper tape punch 
2671 paper tape reader 
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Chapter 22. Teleprocessing (TP) Devices 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 


Special Considerations for EREP Reports 
e Useful reports for these devices are: 


SYSUM 

EVENT 

TRENDS 

PRINT =PT or PS with DEV=nnnn and TYPE=OTH (OBR, MDR 
and MIH records) 


Care should be taken when requesting reports other than these as the results 
could be misleading. 


Some of the devices listed below may produce different record types. In that 
case, request that record type when requesting Detail Edit and Summary 
(PRINT) reports. 


e In OBR records, EREP|sees the 3725 communications controller as a 3705. 
Therefore, if you want to isolate an OBR record from a 3725 controller, you 
must request the Detail report using DEV =3705 and TYPE=O. 


e In MDR records, the 3725 has its own device code, so you can select records 
by coding DEV = (3725) and TYPE=T. 


e In the MDR Detail Summary report, the LIB ADDR field contains the line 


interface base address for 3705s. If the field is all zeros, it means the error is 
in the device rather than in the line. 


Special Considerations for EREP Controls 
e The LIA/LIBADR and TERMN parameters are for use with TP devices. 


LIA/LIBADR is for 3705/3725 communications controllers, and TERMN is 
for 2700 terminals and 3705 controllers. 


Chapter 22. Teleprocessing (TP) Devices 22-] 


TP Devices 


Other Considerations 


e In the case of the TERMN parameter, EREP does not limit the device or 
record type in response to the parameter alone. You must also code 
TYPE=OT and DEV = (27XX,3705) to limit a report to TCAM and/or 
VTAM records from terminals with the specified name(s). 


In 3705 and 3725 communications controllers, the NCP does not recognize and 
pass on XA-specific MDR record information. Instead, the 3725, for example, 
always records 370-mode MDR records. This is true even when the device 
involved is generating XA-mode records. 


Devices Supported by EREP 
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These teleprocessing products are valid for DEV= 


1030 data collection system 

1050 data communications system 
1060 data communication system 
1130 computing system 

115A Western Union terminal 
2701 data adapter 

2702 transmission controller 

2703 transmission controller 

2715 transmission controller 

2740 communication terminal 
2741 communication terminal 
2760 optical image unit 

2770 data communication system 
2780 data transmission terminal 
2790 data communication system 
27XX 

2947 check collection controller 
2970 banking terminal 

2972 = station control unit 

3670 brokerage branch office system 
3700 terminal 

3704 communications controller 
3705 communications controller 
3725 communications controller 
3735 programmable buffered terminal 
3791 cluster controller 

37XX 

3945 station control unit 

3968 terminal controller 

83B3 AT&T terminal 


Note: 27XX and 37XX are general device type designations that include families of 
IBM communications devices and controllers. 


J 


J 


TP Devices 


Bibliography 
The following publications provide detailed information about the devices: 
@ 3705 Communications Controller Theory and Maintenance Manual, SY27-0107. 


@ 3705-80 Communications Controllers Theory and Maintenance Manual, 
Volume 1, SY27-0208. 
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Chapter 23. Other Devices 


The information in this subsection could be changed or superseded by newer 
information added under specific device types. If you are interested in a new 
device or machine number, look under the specific number. 


Special Considerations for EREP Reports 


The channel-to-channel adapter, CTCA, appears as ““CACA” on report output, 
because the characters must be translated to hexadecimal digits. 


Special Considerations for EREP Controls 


None. 


Devices Supported by EREP 
These device and machine type designations are valid for DEV = 


2280 high speed microfilm output film recorder 
2282 film recorder/scanner 

2495 magnetic tape cartridge reader 
2930 tape inter-system connection unit 
2955 remote service terminal 

2956 badge and badge/card reader 
3838 array processor 

3848 cryptographic unit 

7443 service recording facility 

7770 audio response unit 

7772 audio response unit 

BAO00 serial OEM interface adapter 
CTCA channel-to-channel adapter 


In addition, EREP also recognizes the following “unknown” device types: 
2101 
3703 


3967 
125D 
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BA00 SOEMI Adapter 


BA00 Serial OEM Interface Adapter J 


Special Considerations for EREP Reports 


Useful reports for this device are: 


SYSUM 

EVENT 

TRENDS 

PRINT =PT or PS with DEV=(BAO0) and TYPE=O. 


Care should be taken when requesting reports other than these as the results could 
be misleading. 


Special Considerations for EREP Controls 


Other Considerations 


Bibliography 
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“BAOO” is valid for DEV = 


The SOEMI adapter generates OBR records. The OBR code for the device is 
X’1014’. 


> 


Serial OEM Interface (SOEMI) Description and Programmer's Reference, 
GA33-1585, describes the interface that dictates the characteristics of the 
SOEMI adapter. 


Chapter 24. System Control Programs (SCPs) 


The information in this subsection could be changed or superseded by newer 
information added under specific SCPs. If you are interested in a new system 
release, look under the individual SCP. 


This section of the book contains information specific to each of the three families 
of operating systems that use EREP. The SCP-specific considerations presented 
here include: 


e The creation and processing of software records 
e The initialization of the error-recording data set (ERDS) 
e Other notes that may be of help 


Considerations for EREP Reports: 
Useful reports for these devices are: 


SYSUM 

TRENDS 

EVENT 

SYSEXN 

PRINT = PT or PS with whichever of the following record types the SCP gen- 
erates: 


E Recovery/termination (Formerly EOD) 
H Missing interrupt (MIH) 

I System initialization (IPL) 

S Software (SFT) 


Care should be taken when requesting reports other than these as the results could 
be misleading. 
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General Information 


Information about the VSE SCP 


Your VSE (formerly DOS) operating system may not include the latest level of 
EREP. The VSE and VSE/Advanced Functions systems currently are packaged 
with EREP Version 3 Release 1. 


However, if the SCP for your installation is older than VSE/Advanced Functions 
Release 2.0 or VSE Release 1.3.5, it could include only EREP Version 1 Release 
1. If this is the case, you cannot get System Exception reports, or other reports 
for the newer devices. Even though these things are documented in this book, 
they do not apply to your installation. 


The Creation and Processing of Software records 


The VSE systems do not create type X’4X’ software (SFT) records in response to 
abnormal termination. They do, however, record events closely associated with 
system operation, in system initialization (IPL) and termination (EOD) records. 
These records are created by the Reliability Data Extractor (RDE), a system com- 
ponent that is standard in VSE/Advanced Functions and optional in earlier VSE 
systems. 


EREP processes these records for the System Summary and Trends reports, 
grouping them among PROGRAM ERRORs. IPL and EOD records are also 
included in the System Error Summary report of the System Exception series, 
under IPL/RESTART/TERMINATION. 


The IPL record includes a reason code and a subsystem code, supplied by the 
operator as part of the interactive IPL process. These two codes help identify the 
reason for the IPL and the device or program (if any) that failed. 


The EOD record is written in response to a ROD (record on demand) command 
issued before shutting down the system for the day. The ROD command forces 
the dumping of statistical data counters and buffered logs to SYSREC, thus pre- 
serving the latest environmental data about your hardware systems. It also causes 
RDE to write the end-of-day record to SYSREC. 


See Chapter 10, “Error Records for EREP” for the formats of IPL and EOD 
records, and VSE/Advanced Functions Operating Procedures for information about 
RDE messages associated with IPL and end of day. 


Initialization of the Error Recording Data Set (ERDS) 
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The VSE error-recording data set is called the system recorder file, or SYSREC, 
and is assigned the logical name IJISYSRC. SYSREC is created on the SYSRES 
volume during the first IPL following system generation. The SYSRES volume 
also contains the hard copy file (JSYSHC) and the system history file 
(IFSYSHF). 


In this book, SYSREC refers only to the system recorder file, or ERDS. 


Other VSE Notes 


Other Notes 


The operator creates and initializes SYSREC by issuing the IPL command SET 
RF=CREATE. As initialized, SYSREC consists of a header record and, if 
needed, frame records for 303X processors. See “ERDS Formats” in 

Chapter 10, “Error Records for EREP” for the contents of the SYSREC header. 
Unless the file itself is damaged, you should not need to reinitialize it except at 
system generation.! 


You cannot reinitialize SYSREC without re-[PLing the system and re-issuing the 
SET RF=CREATE command. The EREP control parameter ZERO and the 
special EREP program JFCOFFLD merely zero out the data set; they do not 
remove the header or the 303X frame records, if present. 


See your System Management Guide for detailed information about the kinds and 


amounts of disk space required for SYSREC, and about creating this VSE system 
file. 


@ 303X frame records on SYSREC might have to be subdivided because of 
main storage space limitations. The headers for both machine-check and 
channel-check frame records contain switches at offsets 3 and 4 that help keep 
track of the subdivided records. The mapping for the switches follows. 


Byte 0 Sequence number of this frame within a set of frames. 
Byte 1 


Bit 0 Last record of a frame. 
Bit 1 Set for all records of the last frame in a set of frames. 


e Do not confuse the EREP history data set with the VSE history file named 


IJSYSHF. 


The VSE history file contains information about the components of the 
system and the program fixes applied to those components. It is updated by 
MSHP (Maintain System History Program) and reflects the change level of 
your system. 


The EREP history data set contains error records, either copied directly from 
SYSREC or accumulated after a report is run. It can be a cumulative data 
set, updated daily or weekly. It can be used as input to the EREP program, 
either by itself or in combination with SYSREC. Note that the EREP history 
data set is not created by the system; it is created when you specifically 
request it during an EREP run. 


l If your system is running on a 303X processor, you must examine (via EREP) and 


recreate the recorder file whenever an engineering change is installed that afects the 
frame records. 
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The following publications have more information about the functions of the VSE 
systems discussed here: 


VSE System Data Management Concepts, GC24-5209. 
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General Information 


Cc Information about the MVS SCP 


The Creation and Processing of Software (SFT) Records 


VS1 VTAM and MVS software records — X’4X’ reflect software abends of both 
application and system programs. IBM system components’ recovery routines 
create SFT records whenever IBM code is known or suspected to be the cause of 
a failure. The records contain data about SCP failures, operator-initiated restarts, 
and, for MVS, about program damage caused by machine checks. The software 
record consists primarily of the system diagnostic work area (SDWA), a control 
block built during error recovery processing that contains all the pertinent data 
about the failure the recovery routine is able to find. 


See “Software (SFT) Error Record” on page 10-46 for more information about 
the software record produced by MVS systems. 


Initialization of the Error Recording Data Set (ERDS) 


Other MVS Notes 


SYS1.LOGREC is created and initialized at system generation by the disk initial- 
ization program, IFCDIPOO. In all MVS systems except MVS/XA, 
SYS1.LOGREC must reside on the system residence volume. 


As initialized, LOGREC consists of a header record and, possibly, frame records 
for 303X processors,? followed by space for error and environmental records. See 
“ERDS Formats” in Chapter 10 for the contents of the LOGREC header. 


If necessary, you can run the IFCDIP00 service aid to reinitialize 
SYS1.LOGREC. Only IFCDIPOO can update the 303X frame records. You can 
also use IFCDIP00, together with the IEHPROGM utility, to reallocate the 
SYS1.LOGREC data set. See SPL: SYS1.LOGREC for details. 


When running EREP under an MVS system, you can combine history data sets as 
input to EREP simply by concatenating DD statements for them to the ACCIN 
DD statement. You will need to make sure the space allocated for the 
DIRECTWK data set is large enough to hold all the input records, as EREP 
copies the records to DIRECTWK before starting its selection processing. 


2 In MVS’s LOGREC, the header is followed by a time-stamp record for use in IPL 
records. 


The MVS SCP 24-5 


Multisystem Environment 


Running EREP in a Multisystem Environment 
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In a multisystem environment, where I/O devices are shared between processor 
systems, special care is required to make sure you get complete and accurate 
reports about the shared devices. Some suggested procedures, for MVS-MVS 
installations, are: 


e Put all DASDID, LIMIT and SHARE statements into a separate data set. 


— Specify the data set name on the SYSIN DD statement for System 
Summary, System Exception, Trends, Threshold, and any PRINT reports 
for shared I/O devices. 


— Do not use PARM=‘CARD?’ im these steps; instead, code the EREP 
parameters on the EXEC statement. 


@ Reorder the EREP job steps shown in Part 2 to run the processor and SCP 
Detail reports before the system-level reports. For example: 


1. Offload LOGREC to a working data set without requesting any printed 
report. 

Run MCH and CCH Detail PRINT reports. 

Run software Detail PRINT reports. 

Run Detail PRINT reports for dedicated I/O devices (for example, 2305). 
Run Event History against the working data set. 

Concatenate the history data sets from each system on the ACCIN DD 
statement, and run the following reports: 

— System Summary 

— System Exception 

— Detail PRINT reports for shared I/O devices. 


oe tS 


Note: You may not want to run all of these reports every time, select the 
ones you need, deleting the steps that request reports you do not 
want. 


7. Add the records from the concatenated data sets to any existing “perma- 
nent” history data set. 


@ Develop a technique to make sure that each system’s LOGREC has been 
copied before the first step that uses concatenated input runs. For example, 
include a step that creates a named data set, then test for that data set before 
requesting the first system-level report. 


@ Install this procedure on each system in the complex, so reports can be run 
from any one of them at any time. 


c 
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Bibliography 


The following publications have more information about the functions of the 
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Error Recording 


Information about the VM SCP 


VM Error Recording 
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The input to EREP through VM can be quite different from the input used by the 
other systems, because VM creates records differently. 


Both the VSE and MVS systems write records to their ERDS via SVC 76. When 
a VSE or MVS system is running in a virtual machine, VM can tell when the 
guest system issues an SVC 76, and can divert the record to its own error- 
recording area. In the process, VM translates the virtual address of the device 
originating the record to a real address, so the records are meaningful to a user. 


However, VM does not divert every record created by a guest system to the error- 
recording area. Some records it “reflects back” to the virtual machine to be 
recorded on the guest system’s ERDS. The records reflected back could be from 
devices dedicated to the virtual machine, or could be of certain types, or could 
contain an error. When VM reflects a record back to the virtual machine, the 
addresses in the record remain virtual. 


This means that sense data logged for I/O error conditions, if reflected back to the 

virtual machine, 1s associated with a logical device rather than the actual device. 

Such sense data is of little use in identifying problem devices. 

VM’s reflecting back of some records to the virtual machine also means that it is 

possible for your installation’s error records to be divided between the VM error- 

recording area and your operating system’s ERDS. 

Figure 10-6 on page 10-12 shows all the records created by VSE or MVS 

systems, and all the records VM records in its own error-recording area. Here is a 

list of the records VM does not record on behalf of the guest system: 

@ Machine Check Type 13: MCH in multiple storage environment 

@ Channel Check Type 21: CCH in multiple storage environment 

@ Unit Check Types 34 and 36: TCAM and VTAM OBRs 

e Software (SFT), Type 4X 

e System Initialization (IPL), Type 5X 

e System Termination (EOD), Type 8X 

@ Miscellaneous Data/Non-Standard Type 90: MDR from SVC 91 

Note: VM creates its own type 2X CCH error record before detecting the guest 
system's SVC 76 for that record type. Thus, even though it reflects the type 


21 record back to the virtual machine, the incident is recorded in the error- 
recording area. 


2 


C 


ERDS Initialization 


Capturing All the Data for EREP 


When CPEREP runs EREP for you, it uses the records in the VM error-recording 
area as the only input (unless you use the HIST or MERGE operand). The 
SERLOG FILEDEF, which implies SYSREC or SYS1.LOGREC input, is only a 
simulation of that data set, required because of format differences between the 
error-recording area and the system ERDS. No SERLOG file actually exists, and 
CPEREP uses neither SYSREC nor SYS1.LOGREC as the source of record input 
for EREP. 


The result of this could be misleading report output, because the VM error- 
recording area did not contain all the records that would have been on SYSREC 
or LOGREC. This can be a problem especially with OBR records for your TP 
devices: if you run EREP only under VM, you will not see these records in any 
report output, and you might be missing some errors. 


One way to make sure you get reports about all the possible errors in your system 
is to run EREP under VM and then run it again under the guest operating system 
— VSE or MVS. The second EREP run would include data not recorded by VM. 


Another way to make sure you are seeing all your error records in the EREP 
reports is to combine the data from your system’s ERDS and the error-recording 
area before requesting any reports. Then run EREP under either system using the 
combined records as history input. 


Initialization of the Error Recording Data Set (ERDS) 


When the VM ERDS is on a count-key-data device, it consists of at least two 
adjacent cylinders allocated on the system residence pack. Accordingly, the VM 
ERDS is sometimes referred to as the “error-recording cylinders.” 


When the VM ERDS is on a fixed-block-architecture device, it consists of any 
number of adjacent pages assigned on the system residence volume. Accordingly, 
the VM error-recording routines see the ERDS as a series of logical pages. 


At system initialization, the error-recording area is initialized by CP routines that 

format each of the recording cylinders and set up the logical pages to receive error 
records. Each recording cylinder has a header and, possibly, 303X frame records, 
followed by the space for error records. 


To reinitialize the error-recording area, you issue the CPEREP command speci- 
fying CLEAR or CLEARY as the only operand. CLEAR creates a new header 
and re-formats each cylinder; CLEARF does the same, and also replaces the 
frame records with the latest frames from the 303X Service Recording File. The 
CLEARF operand is the only way to update the frames in the error recording 
area. 


See “VM Notes” on page 4-51 for information about using the CLEARF 
operand. 


See “ERDS Formats” in Chapter 10 for the contents of the error-recording cyl- 


inder header. For other details about VM error recording, see the OLTSEP and 
Error Recording Guide for your VM facility. 
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Glossary 


_ The following terms are defined here so that all can 
agree on what a word is supposed to mean in this book. 
Some of the definitions are taken from the IBM Vocab- 
ulary for Data Processing, Telecommunications, and 
Office Systems; others are from Webster's Third New 
International Dictionary. Still others are derived from 
the way the words are used in this book. 


acronym. A combination of letters, usually the first 
ones, that stand for a multi-word name or expression. 
For example, “EREP” is the acronym for IBM’s Envi- 
ronmental Record Editing and Printing program. 


CCF. Channel-check frame. The record on the ERDS 
that EREP uses to format channel-check records from 
the 303X group of processors. 


CCH. Channel-check handler. A S/370 hardware 
feature that, when a channel error occurs, records infor- 
mation about the error and issues a message to the 
operator. In VSE, machine check analysis and 
recording (MCAR) performs a similar function. The 
records created in both cases are called CCH records. 


CE. IBM Customer Engineer. 


Channel. The physical connector between a processor 
and an input/output device, usually via a control unit of 
some kind. In the case of the extended architecture 
(System 370/XA), the hardware channels are replaced 


by subchannels, which are capable of dynamic variation 
controlled by microcode in the processor complex. 


In this book, we refer to “subchannels” when talking 
about fields in 370-XA report output, for example, but 
use “channel” in the general sense to mean the con- 
nection between controller and device. 


Code. The programming-language instructions that 
make up a computer program. As a verb, “to code” is 
the same as “to write code.” 


Controller. A single unit which provides an interface 
between one or more SCUs and a group of devices. It 
usually resides within the same unit as the lowest drive 
addresses. 


CRW. Channel-report word. In S/370-XA, the 
channel-report word is part of the channel-subchannel 
recovery mechanism. It contains information about 
channel incidents reported through machine checks, 
specifying the error environment and the severity of the 
error. MVS/XA builds a CRW record that, in combina- 
tion with the subchannel logout handler (SLH) record, 
replaces the CCH record. 


[P 


DDR. Dynamic device reconfiguration. A facility that 
allows a demountable volume to be moved, and reposi- 
tioned if necessary, without abnormally terminating the 
job or repeating the IPL procedure. The MVS oper- 
ating systems create DDR records to provide informa- 
tion about operator-assisted recovery involving the 
relocation of tape and movable DASD volumes. 


DOS. Disk Operating System. An obsolete name, 
replaced by VSE, Virtual Storage Extended. In this 
book, “VSE” includes and implies all releases of this 
operating system, from DOS to VSE/Advanced Func- 
tions. 
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ERDS. The error-recording data set; input to the 
IFCEREP! program. In MVS systems, the ERDS is 
SYS1.LOGREC; in VSE systems, it is SYSREC; in VM, 
it is the error-recording area or cylinders. 


ERP. Error-recovery program/processing; the system 
routines that detect and process errors, writing records 
to the ERDS. 


H 


Hard machine check or error. A hardware error that 
disables the processor or other unit. 


[| 


Installation. A data processing system location: a com- 
puter center housing processors, I/O devices, other 
hardware devices, the software that controls the 
machines, and the people that control the computer 
center. 


IPL. Initial program load. The process by which an 
operating system is initialized at the beginning of the 
day or session. At IPL, the system operator enters the 
installation-specific information the operating system 
must have in order to manage the installation’s com- 
puting system and handle the installation’s application 
programs. This information includes system parameters, 
system data set definitions, and other information 
needed so the operating system can begin operating. 


MCF. Machine-check frame. The record, on the 
ERDS, that EREP uses to format machine-check 
records from the 303X group of processors. 


MCH. Machine-check handler. A S/370 hardware 
feature that analyzes errors and attempts recovery by 
retrying the failing instruction. If unsuccessful, i¢ causes 
an interrupt that triggers the creation of an error 
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record. In VSE systems, machine check analysis and 
recording (MCAR) performs similar functions. The 
records created in either case are called MCH records. 


MDR. Miscellaneous data record. A record type that 
records error and usage information from buffered 
control units or communications controllers, and device 
failures on TP devices connected to 3705/3725 commu- 
nications controllers. The record is created when there 
is an overflow of statistical counters; its purpose is to 
provide more information about the accompanying 
failure. 


MIH. Missing-interrupt handler. An MVS and 
MVS/XA facility that keeps track of I/O interrupts, 
informing the operator and creating a record whenever 
an expected interrupt fails to occur in a pre-set time 
interval. 


MVS and MVS/XA. Multiple Virtual Storage and 
Multiple Virtual Storage/Extended Architecture, two 
versions of the System/370 operating system that are 
extensions of OS/VS2. 


In this manual the term “MVS” is used to refer to a 
family of operating systems that control IBM 
System/360 and System/370 computing systems. 
“MVS” includes OS/VS1, OS/VS2, MVS/370, and 
MVS/XA. 


[o| 


OBR. Outboard recorder. In VSE systems, the out- 
board recorder is a feature that records pertinent data 
about an unrecoverable I/O error. MVS systems create 
a similar record from information recorded when an I/O 
device is in unit-check status. The resulting record in 
both cases is called an OBR record. 


OS/VS. Operating System/Virtual Storage. A family 
of operating systems that control IBM System/360 and 
System/370 computing systems. OS/VS includes VS1, 

VS2, MVS/370, and MVS/XA. 


In this book, these operating systems are referred to by 
the general term “MVS.” 


OS/VS1. Virtual Storage 1. One of the MVS oper- 
ating systems. 


OS/VS2. Virtual Storage 2 (MVS, Version 1). 
MVS/370; one of the MVS operating systems. 


P| 


PCT. Product control table. The internal table that 
contains the data EREP needs in order to identify and 
process records from a particular IBM device or 
product. 


PSR. IBM Programming Service Representative. The 
person responsible for helping you maintain the IBM 
software in your installation. 


| 


RCT. Record control table. 


S/370 and S/370-XA. System/370. The computing 
systems built around large IBM processors. XA stands 
for Extended Architecture, the architecture basis for the 
3081 and later processors, characterized by 31-bit 
addresses. S/370 implies not only the processor but also 
the many other data processing devices that can be con- 
nected to it to make a 370 (or 370-XA) data processing 
system. 


SCP. System control program. The minimum software 
package that will make your operating system work. 


SCU. Storage control unit. A functional unit which 
resides between channel(s) and controller(s). 


SLH. Subchannel-logout handler. A S/370-XA feature 
that provides detailed model-independent information 
relatir:; to a subchannel; the subchannel logout 
describes equipment errors detected by the channel sub- 
system. MVS/XA builds an SLH record that, in combi- 
nation with the CRW record, replaces the CCH record. 


Soft machine check or error. A hardware error that is 
not disabling. 


Subchannel. The extended architecture version of 
“channel”; see the explanation of “channel” in this 


Glossary, and the Principles of Operation for System/370 
Extended Architecture. 


Subsystem. In hardware terms, a group of devices that 
function together to perform I/O operations. An I/O 
subsystem can consist of a control unit (controller) and 
its associated drives — either disk or tape; or it can 
consist of all the DASD or tape storage — including 
drives and controllers — in an installation. In the case 
of newer DASD, the I/O subsystem also includes 
storage control units (SCUs) and storage directors 
(SDs), within the controller. 


Syntax. The relationships among the elements and 
characters in a parameter or language statement. For 
our purposes, the way you have to code something in 
order for the program to understand and accept it. 


SYSGEN. System Generation. The process of 
selecting optional parts of an operating system and of 
creating a particular operating system tailored to the 
requirements of a data processing installation. Can also 
include I/OGEN, which is the time when the system 
programmer defines the installation’s computing system 
configuration to the operating system. 


VSE. Virtual Storage Extended. A family of disk oper- 
ating systems that controls IBM System/360 and 
System/370 computing systems and includes VSE and 
VSE/Advanced Functions. 


VS1. Virtual Storage 1. One of the OS/VS operating 
systems. 


VS2. Virtual Storage 2 (MVS, Version 1). MVS/370; 
one of the OS/VS operating systems. 


VM. Virtual Machine. A time-sharing system control 
program that manages the resources of an IBM 
System/370 computing system so that multiple remote 
terminal users have a functional simulation of the com- 
puting system (a virtual machine) at their disposal. In 
this book, “VM” means all versions of the Virtual 
Machine system control program, including VM/370, 
VM/System Product, VM/SP/High Performance Option, 
and VM/XA Migration Aid. 
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Abbreviations Used in EREP Output 


BPI 


BUFE 


BYTES RD/SRCHD 


CCH 


CCH-CRH 


CCH-INC 


CDDA 


CHK 


CHNL 


CHP 


CHPID 


CK 


CLNACT 


CMD 


CMND 


CNT 


CNTRL 





CNTRLR 


COMP 


CONS + UR 


CORR 


COR 


Bits per inch 

Buffer error 

Megabytes read/searched 
Channel check handler 


CCH-channel reconfigura- 
tion hardware 


CCH incomplete record 
Command data 

Check 

Channel 

Channel path ID 
Channel path ID 
Check 

Cleaner action 
Command 

Command 

Count 

Control 

Controller 

Component 

Console plus unit record 
Correctable 


Corrected 


CP 


CPU 


CRW 


CSECTID 


CSID 


CSW 


CT 


CTLID 


CTLR 


CU 


CUA 


DATAXFR 


Central processing unit; 
interchangeable with 
“processor” 

Central processing unit 


Channel report word 


Control section (CSECT) 
identification 


Channel set ID 
Channel status word 
Controller; count 
Controller ID 
Controller 

Control unit 


Channel-control unit-device 
address 


Data transfer 


DATA CKS CORR/RTRY Data checks 


DDR 


DDR-OPR 


DDR-SYS 


DEV 


DEVNO 


DEVNUM 


DEVT 


correctable/retry 


Dynamic device reconfigura- 
tion 


DDR-Operator requested 
DDR-System requested 
Device number 

Device number 

Device number 


Device type 
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DNO 
DRCT 
DTE 
EOD 
EQUCHK 
EQUIP 


ERDS 


ERROPS 
ERSGAP 
ESW 
EXTD 
FCG 
FLG 
FMT 


HDR SER 


HIRS 


ID 

INV 
INVK 
IPL 

IRB 
LEN 
MB 
MBYTE 


MCH 


MCH-TRM 


MCK 


Device number 

Storage director 

Date 

End of day 

Equipment check 
Equipment 
Error-recording data set: 
SYS1.LOGREC (MVS), 
SYSREC (VSE), error 
recording area (VM) 
Error operations 

Erase gap 

Extended status word 
External damage 
Floating channel group 
Flag 


Format 


Header (tape)/serial number 
of drive that created tape 


Hardware instruction retry 
(successful) 


Identification 

Invalid 

Invoked 

Initial program load 
Interrupt response block 
Length 

Megabyte 

Megabyte 

Machine check handler 
MCH-System terminated 


Machine check 
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MDR 
MDR-DAS 
MIH 
MIH-CE 
MIH-DE 
MOD 
OBR 
OBR-DMT 


OBR-DPA 


OBR-EOD 
OBR-PRM 
OBR-SHT 
OBR-TMP 
OVERRN 
OVERRUN CDDA 
OVRN 


PCUA 


PERM 

PFU 
PRGM INT 
PRI 

PRM 


PROG-EC 


PSW 
RCVRYXIT 
RD(S) 


REC-TYP 


Miscellaneous data record 
DASD MDR record 
Missing interrupt handler 
MIH-channel end pending 
MIH-device end pending 
Module 

Outboard record 
OBR-demount record 


OBR-dynamic pathing avail- 
ability 


OBR-End-of-day 
OBR-Permanent error record 
OBR-Short record 
OBR-Temporary error 
Overrun 

Overrun command data 
Overrun 


Primary channel-control 
unit-device address 


Permanent 

Probable failing unit 
Program-initiated 
Primary 

Permanent 


Program-extended control 
mode 


Program status word 
Recovery exit module 
Read error(s) 


Record type 


J 


RTN 
RTRY 
SCSW 
SCP 
SCU 


SCUA 


SCUID 
SD 
SEC 


SEEKS CNTR/HH 


SFT 
SLH 
SFT-ABN 


SFT-MCH 


Routine 

Retry 

Subchannel status word 
System control program 
Storage control unit 


Secondary channel-control 
unit-device address 


Storage control unit ID 
Storage director 
Secondary 


Seek errors cylinder 
track/head 


Software (record) 
Subchannel logout handler 
SFT-ABEND record 


SFT-machine error, recover- 
able 


SFT-PI 
SFT-RST 
SIO 

SKS 
SNID 
SPID 
SRCHD 
SSYS ID 
STOR 
TEMP 
TERM 
TMP 
UCB 
VOLID 


WRT(S) 


SFT-program interrupt 
SFT-restart 

Start I/O 

Seeks; data access errors 
Sense path group ID (DPA) 
Set path group ID (DPA) 
Searched 

Sub-system identifier 
Storage error 

Temporary 

Terminal 

Temporary 

Unit control block 
Volume serial number 


Write error(s) 
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Associated Publications 


The following pages list the IBM manuals either 
referred to in this book or associated with this book and 
the use of EREP. 


For DOS/VS and DOS/VSE 
Users: 


@ DOS/VSE System Control Statements, GC33-5376. 
Contains detailed information about the system 
controls required when running EREP under 
DOS/VSE. 


@ DOS/VSE Messages, GC33-5379. Lists and inter- 
prets the messages that IBM’s DOS/VSE issues to 
the operator and the programmer. 


®@® DOS/VSE Serviceability Aids and Debugging Proce- 
dures, GC33-5380. Aids System/370 operators and 
programmers in determining and isolating the cause 
of a DOS/VSE system malfunction. 


@® DOS/VSE Error Recovery and Recording Transients 
Logic, SY33-8552. Provides general information 
and detailed flowcharts of the Recovery and 
Recording Transient Programs of DOS/VSE. 


For VSE/Advanced Functions 
(VSE/AF) Users: 


@ VSE/Advanced Functions, System Management 
Guide, SC33-6191. A guide for users of the 
VSE/AF operating system. It includes information 
about using EREP under VSE and VSE/AF. 


@ VSE/Advanced Functions, System Control State- 
ments, SC33-6198. The VSE/AF version of 
SC33-5376. 





@  VSE/Advanced Functions, Messages and Codes, 
SC33-6098. The VSE/AF version of SC33-5379. 


@ VSE/Advanced Functions, Diagnosis: Service Aids, 
SC33-6195. The VSE/AF version of SC33-5380. 


@ VSE/Advanced Functions, Diagnosis Reference: 
Error Recovery and Recording Transients Logic, 
LY33-9108. Provides general information and 
detailed flowcharts of the Recovery and Recording 
Transient Programs of VSE/AF. 


For VSE/System Package 
(VSE/SP) Users: 


@ VSE/System Package, Messages and Codes, 
SC33-6181. Interprets the messages that VSE/SP 
issues to the operator and the programmer. 


For OS/VS1 Users: 


@® OS/VSI JCL Reference, GC24-5099. Describes 
how to code job control language statements to 
override default parameters, use cataloged proce- 
dures, and allocate space for data sets. 


@ OS/VS1 Utilities, GC26-3901. Describes how to 
use utility programs to print certain types of service 
aid output and to allocate data sets with the 
IEHPROGM utility. 


@ OS/VS1 SYS1,.LOGREC Error Recording, 
GC28-0668. Describes how to use the IFCDIP00 
service aid program and how error records are built 
and recorded on SYS!1.LOGREC. 


e@ OS/VS Message Library: VS1 System Messages, 
GC38-1001. Describes the messages issued by the 
IFCDIP00 service aid program. 

e@ OS/VSI SYS1.LOGREC Error Recording Logic, 
SY28-0669. Describes the internal logic of 


Associated Publications X-9 


IFCDIP00 and the system recording routines: DDR 
recorder, the deferred incident recorder, MCH 
emergency recorder, MCH error recorder, miscella- 
neous data recorder, outboard recorder, SVC 76, 
SVC 91 and VTAM SYS1.LOGREC recorder. 


OS/VSI Recovery Management Support Logic, 
SY24-5170. Describes the function and logic of the 
machine check handler, the channel check handler, 
and dynamic device reconfiguration. 


For OS/VS2 (MVS/SP Version 
1 or MVS/370) Users: 


OS/VS2 MVS Utilities, GC26-3902. Describes how 
to use utility programs to print certain types of 
service aid output, and to allocate data sets with the 
IEHPROGM utility. 


OS/VS2 MVS SPL: SYS1.LOGREC Error 
Recording, GC28-0677. Describes how to use the 
IFCDIP00 service aid program and how error 
records are built and recorded on SYS1.LOGREC. 


OS/VS2 SPL: Debugging Handbook, GC28-1047. 
Contains the control blocks used in MVS, including 
the SDWA (System Diagnostic Work Area). 


MVS JCL, GC28-1300. Describes how to use job 
control language statements; how to override 
default parameters, use cataloged procedures, and 
allocate space for data sets; and how to use JES2 
and JES3 control statements with other JCL state- 
ments. 


OS/VS Message Library: VS2 System Messages, 
GC38-1002. Includes the messages issued by the 
IFCDIP00 service aid program. 


OS/VS2 SYSI.LOGREC Error Recording Logic, 
SY28-0678. Describes the internal logic of 
IFCDIP00 and the system recording routines: asyn- 
chronous recording facility, DDR/MIH recorder, 
MCH emergency recorder, OBR/MDR recorder, 
SVC 76, and SVC 91. 


OS/VS2 System Logic Library, Volume 7, 
LY28-1083. Describes the function and logic of the 
channel check handler, dynamic device reconfigura- 
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tion, the machine check handler, and the missing 
interrupt handler. 


For OS/VS2 (MVS/SP Version 
2 or MVS/XA) Users: 


MVS/Extended Architecture JCL, GC28-1148. 
Describes how to use job control statements to 
override default parameters, use cataloged proce- 
dures, and allocate space for data sets; and how to 
use JES2 and JES3 control statements with other 
JCL statements. 


MVS/Extended Architecture Message Library: 
System Messages, GC28-1156. Includes the mes- 
sages issued by the IFCDIP00 service aid program. 


MVS/Extended Architecture SYS1.LOGREC Error 
Recording, GC28-1162. 


MVS/Extended Architecture Debugging Handbook, 
Volume 5, GC28-1168. Documents the structure 
and contents of MVS/XA system control blocks, 
including the SDWA (System Diagnostic Work 
Area). Describes how to use the IFCDIPO00 service 
aid program and how error records are built and 
recorded on SYS1.LOGREC. 


MVS/Extended Architecture Data Administration: 
Utilities, GC28-4018. Describes how to use utility 
programs to print certain types of service aid 
output, and how to allocate data sets with the 
IEHPROGM utility. 


MVS/Extended Architecture SYS1.LOGREC Error 
Recording Logic, LY28-1187. Describes the 
internal logic of IFCDIP00 and the system 
recording routines: asynchronous recording facility, 
OBR/MDR recorder, SVC 76 and SVC 91. 


MVS/Extended Architecture System Logic Library, 
Volume 8, LY28-1234 and LY28-1235. Describes 
the function and logic of the missing interrupt 
handler and the subchannel logout handler. 


MVS/Extended Architecture System Logic Library, 
Volume 9, LY28-1238. Describes the function and 
logic of the dynamic device reconfiguration 
recorder and the machine check handler. 


J 





For VM/370, VM/SP, and 
VM/SP HPO Users: 


VM/SP: System Messages and Codes, SC19-6204. 
The VM/System Product version of GC20-1808. 


VM/SP OLTSEP and Error Recording Guide, 
SC19-6205. The VM/System Product version of 
GC20-1809. 


VM/SP HPO OLTSEP and Error Recording Guide, 
SC19-6230. The VM/SP/High Performance Option 
version of SC19-6205. 


VM/370 System Messages, GC20-1808. Includes 
the system messages that relate to the VM/370 
modules supporting EREP (DMSIFC AND 
DMSREA). 





@ VM/370 OLTSEP and Error Recording Guide, 
GC20-1809. Describes the way VM records error 
records originating in a virtual machine running 
under its control, as well as the way VM records 
errors occurring in its own environment. 


For All Users: 


@ IBM System/370 Principles of Operation, 
GA22-7000. Explains in detail the machine func- 
tions of the System/370 processors. 


@ IBM System/370 Extended Architecture Principles of 


Operation, SA22-7085. The MVS/XA version of 
GA22-7000. 
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ACC processing parameter 1-12, 7-5, 9-3, 9-11 
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general bibliography X-9-X-11 
OLTSEP and Error Recording Guide 11-55 
Planning and System Generation, VM_ 10-1 
product-specific bibliographies 15-7, 15-11, 24-4, 
24-7, 24-10 
Serviceability Aids and Debugging 
Procedures 11-62 
System Generation Reference, MVS_ 10-1 
System Management Guide, VSE 10-1, 10-25 
SYS1.LOGREC Error Recording, MVS__ 10-25 
automating the EREP run 3-7 


basic information on EREP 1-1-1-15 
See also introduction to EREP 
BA00 SOEMI adapter 23-2 


Card readers and punches 
product-specific information 13-1-13-2 
CCF records 10-8 
CCH Detail Edit report example 2-65 
CCH Detail Summary example 2-65 
CCH record 10-15 
format, on ERDS_ 10-15 
channel check record for S/370-XA 
See CRW and SLH records 
channel error reporting, limiting 
See LIMIT control] statement 
channel inboard record 
See CCH record 
channel keywords for LIMIT statement 
See LIMIT control statement 
channel report word record 
See CRW record 
Channel Subsystem Exception report 2-21, 2-30 
See also System Exception reports 
checklist for planning your EREP run 2-95 
chronological abstracts of error records 
See Event History report 
chronological summary of all errors, all DP systems 
See Trends report 
CLEAR/CLEARF operand for CPEREP 9-2, 9-3 
clearing the ERDS in an emergency 3-3 
under MVS_ 3-4 
under VM_ 3-3 
under VSE 3-3 
codes for record types 10-11 
coding EREP parameters and control 
statements 6-1-7-3 
coding rules for EREP parameters 7-1-7-3 
coding the LIMIT statement for DASD 15-5 
See also LIMIT control statement 
coding the LIMIT statement for processors and chan- 
nels 20-2 
See also LIMIT control statement 
coding the LIMIT statement for tape 17-5 
See also LIMIT control statement 
coding the LIMIT statement for 3480 17-21 
See also LIMIT control statement 
comments for EREP code 7-3 
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common error-record header 10-10 
communications controllers 
See TP devices 
consoles and displays 
product-specific information 14-1-14-2 
contents of TOURIST data set 8-14, 12-12 
control statement for DASD without physical IDs 
See DASDID control statement 
control statement showing shared I/O devices 
See SHARE control statement 
control statements for EREP 
See EREP parameters and controls 
CONTROLLER control statement 1-13, 8-4, 9-3 
coding 8-4 
description 8-4 
examples 8-5-8-6 
syntax 8-4 
controls for EREP, introducing 1-9 
copying error records from the ERDS 
See history data set 
correcting coding problems 
I/O errors 5-2 
incorrect input 5-2 
storage problems 5-1 
syntax errors 5-1 
using the DEBUG parameter 5-3 
using the TOURIST output 5-3 
CPEREP command 1-3, 1-14, 1-15, 4-49 
CLEAR/CLEARF operand 9-2 
defining files for 4-49 
entering operands 9-8 
coding rules 9-9 
file entry method 9-12 
mixed entry method 9-14 
prompting method 9-10 
examples 
in sample EREP runs 4-39-4-48 
of entering operands 9-10, 9-12, 9-13, 9-14 
invocation sequence 9-9 
operands - EREP controls 5-5, 8-3, 9-1-9-7 
coding 9-3 
syntax 9-7 
running EREP 9-8 
syntax 9-1 
TERMINAL operand 9-2 
TOURIST output from 12-12 
unique EREP controls 9-2 
CPEREP messages 
See DMSIFC**** messages 
CPU selection parameter 1-11, 7-6, 9-3 
CPU Subsystem Exception report 
See Processor Subsystem Exception report 
CPUCUA selection parameter 1-11, 7-7, 9-3 
CPUs 
See processors 
creating a working copy of the ERDS 3-5 
creating an EREP run 
See setting up and running EREP 
CRW Detail Edit report example (370-XA) 2-66 
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CRW record 10-18 
CUA selection parameter 1-11, 7-8-7-9, 9-3 
CUA statistics for tape drives 

See Tape DEVNO/CUA Statistics Summary 
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DASD 
product-specific information 15-1-15-13 
DASD and tape subsystem summaries 2-22 
See also System Exception reports 
DASD data set for history input 
See DIRECTWK data set 
DASD Data Transfer Summary 2-43 
DASD informational messages 2-37 
DASD keywords for LIMIT statement 
See coding the LIMIT statement for DASD 
DASD space required for SYSO01, in VSE 4-18 
DASD storage capacities (chart) 12-11 
DASD Storage Control Unit Summary 2-46 
DASD storage required for DIRECTWK, in 
MVS 4-35 
DASD String Summary 2-38 
DASD Subsystem Exception report 2-21, 2-32 
See also System Exception reports 
DASD Symptom Code Summary 2-40 
DASDID control statement 1-13, 8-7-8-15, 9-3 
configuration in TOURIST output 8-9, 8-14 
description 8-7 
examples 8-12 
how to set up and use 8-9-8-12 
syntax 8-7 
Data Reduction report example 2-67 
data set created by EREP 
See history data set 
data set for EREP messages 
See TOURIST output data set 
data set for the EREP report 
See EREPPT output data set 
data transfer summary 
See DASD Data Transfer Summary 
DATE selection parameter 1-11, 7-10, 9-3 
DD statement for history input 
See ACCIN input data set 
DD statements required for EREP 4-32-4-33 
DDR Detail Edit report example 2-68 
DDR Detail Summary example 2-68 
DDR record 10-21 
format, on ERDS_ 10-21-10-22 
DEBUG parameter 11-63 
coding 11-63 
options available 11-64 
syntax 11-63 
to look at error records 5-3 
default values and actions for EREP parameters 
(chart) 12-9 








Detail Edit and Summary reports 2-62 
See also Detail PRINT reports 
Detail PRINT reports 7-24, 7-25, 9-5 
examples 
CCH Detail Edit 2-65 
CCH Detail Summary 2-65 
CRW Detail Edit (370-XA) 2-66 
Data Reduction report 2-67 
DDR Detail Edit 2-68 
DDR Detail Summary 2-68 
EOD Detail Edit 2-90 
EOD Detail Summary 2-90 
IPL Detail Edit 2-89 
IPL Detail Summary 2-89 
Lost Record Detail Summary (MVS) 2-88 
MCH Detail Edit 2-70 
MCH Detail Summary 2-71 
MDR Detail Edit 2-72 
MDR Detail Summary 2-73 
MIH Detail Edit 2-74 
MIH Detail Edit (370-XA) 2-75 
MIH Detail Sum..ary (370-XA) 2-75 
OBR Detail Edit 2-77 
OBR Detail Summary 2-80 
OBR/MDR Detail Summary 2-81 
Outboard Environment Summary 2-82 
SFT Detail Edit 2-87 
SFT Detail Summary 2-88 
SLH Detail Edit (370-XA) 2-84 
SLH Detail Summary (370-XA) 2-85 
Unknown Detail Edit 2-91 
Unknown Detail Summary 2-91 
general description 2-62 
introduction 2-62 
sample code for 2-63, 4-6, 4-8, 4-9, 4-10, 4-24, 
4-26, 4-27, 4-28, 4-41, 4-43, 4-44, 4-45 
selection parameters for 2-62 
DEV selection parameter 1-11, 7-11-7-12, 9-4 
device classes and types, from the OBR record 12-13 
DEVSER selection parameter 1-11, 7-13-7-14, 9-4 
difference between permanent and temporary errors 
See permanent and temporary errors, defined 
DIRECTWK data set 
DASD space required for 4-35 
introducing 1-15 
under MVS 4-23, 4-24, 4-25, 4-26, 4-27, 4-29, 4-30, 
4-31, 4-32, 24-5 
under VM_ 4-39, 4-49, 4-50, 9-4 
under VSE 4-4, 4-14 
diskette 16-1 
product-specific information 16-1 
DMSIFC**** messages 11-48-11-53 
DOS/VS 
See VSE systems, defined 
DOS/VSE 
See VSE systems, defined 
dynamic device reconfiguration record 
See DDR record 
dynamic pathing availability facility 2-3 


dynamic pathing availability OBR record 10-41, 10-44 


ENDPARM — parameter delimiter 1-13, 7-3, 8-3, 9-4 
Entering CPEREP Operands 9-8-9-15 
EOD Detail Edit report example 2-90 
EOD Detail Summary report example 2-90 
EOD record 
See Recovery/Termination record 
ERDS 
See error-recording data set (ERDS) 
ERDS header record 10-3 
on SYSREC (CKD) 10-4 
on SYSREC (FBA) 10-5 
on SYS1.LOGREC 10-6 
on VM error-recording cylinders 10-7 
EREP and the operating system 
See operating systems and EREP 
EREP control statements 1-9, 8-1-8-22 
See also EREP parameters and controls 
coding rules, general 8-3 
syntax summary (chart) 8-22 
valid for EREP reports (chart) 8-2 
EREP General Input Facility 4-53 
EREP messages 
DMSIFC**** messages 11-48 
IFC**** messages 11-1-11-46 
listed and explained 11-3-11-53 
EREP output 
See output from the EREP program 
EREP parameters 
and EREP reports (chart) 7-4 
coding rules for 7-1 
descriptions 6-4-7-41 
See also individual parameters 
invalid combinations of (chart) 12-2 
summary of default values and actions (chart) 12-9 
syntax rules 6-1-6-3 
syntax summary (chart) 7-41 
to control EREP processing 1-9 
ACC 1-12, 7-5 
HIST 1-12, 7-18 
LINECT 1-12, 7-20 
MERGE 1-12, 7-21 
SHORT | 1-12, 7-26 
TABSIZE 1-12, 7-30 
ZERO 1-12, 7-39 
to request reports 1-9 
EVENT 1-10, 7-17 
PRINT 1-10, 7-24 
SYSEXN 1-10, 7-28 
SYSUM 1-10, 7-29 
THRESHOLD _ 1-10, 7-32 
TRENDS 1-10, 7-35 
to select records for reports 1-9 
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CPU 1-11, 7-6 
CPUCUA 1-11, 7-7 
CUA 1-11, 7-8 
DATE 1-11, 7-10 
DEV 1-11, 7-11 
DEVSER 1-11, 7-13 
ERRORID 1-11, 7-15 
LIA/LIBADR 1-11, 7-19 
MOD 1-11, 7-22 
MODE 1-11, 7-23 
SYMCDE 1-11, 7-27 
TERMN 1-11, 7-31 
TIME 1-11, 7-34 
TYPE 1-11, 7-36 
VOLID 1-11, 7-38 
EREP parameters and controls 
brief definitions of 1-10-1-13 
control statements 1-9, 8-1-8-22 
CONTROLLER 1-13, 8-4-8-6 
DASDID 1-13 
ENDPARM parameter delimiter 1-13 
LIMIT 1-13 
SHARE 1-13 
introduction 1-9 
parameters 1-9, 7-1-7-41 
See also EREP parameters 
syntax and coding rules_ 6-1-7-3 
what they do 1-9 
EREP reports 1-4, 2-19 
CPU letter assignments in 2-92 
Detail reports 2-62-2-91 
See also Detail PRINT reports 
Event History 2-12-2-19 
See also Event History report 
interpreting, in general 2-92 
one per EREP run 1-4 
System Exception series 2-20-2-57 
See also System Exception reports 
System Summary 2-2-2-6 
See also System Summary report 
Threshold Summary 2-58-2-61 
See also Threshold Summary report 
Trends 2-7-2-11 
See also Trends report 
valid selection parameters for (chart) 7-4 
EREP return codes 11-54 
EREP’s work data set for history input 
See DIRECTWK data set 
EREPPT output data set 1-5, 1-14, 1-15 
error recording area 
clearing, in emergency 3-3 
ERDS for VM systems 1-1 
format 10-3 
frame records on 20-4 
header format 10-7 
how VM records error records 24-8 
input for EREP 24-9 
reinitializing 20-5 
statistical data on 3-2 
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error records 
mappings 10-2 
on the ERDS 1-1, 10-1 
processed by EREP 1-2 
standard header fields 10-10 
type codes 10-11 
where they come from 1-1 
error-recording data set (ERDS) 1-1, 1-2 
See also introduction to EREP 
clearing, in emergency 3-3 
under MVS_ 3-4 
under VM_ 3-3 
under VSE 3-3 
each operating system in an installation you will 
have a separate ERDS_ 1-7 
frame records on 20-4 
initializing 24-2, 24-5, 24-9 
managing data on 3-1 
See also managing error data for EREP 
reinitializing 9-2, 20-5 
statistical data on 3-6 
added for certain reports 3-6 
ERRORID selection parameter 1-11, 7-15-7-16, 9-4 
Event History report 7-17, 9-4 
general description 2-12 
introduction 2-12 
sample code for 2-12, 4-11, 4-29, 4-46 
selection parameters for 2-12 
EVENT report parameter 1-10 
examples 
of DASDID control statements 8-12 
of EXECs for running EREP under VM 4-38 
of JCL for running EREP under MVS 4-20 
of JCS for running EREP under VSE 4-2 
of LIMIT control statements 15-6, 17-7, 20-3 
of report output 2-4-2-96 
See also entries for individual reports 
of SHARE control statements 8-21 
of TOURIST output 8-14, 12-12 


fault symptom code summary for DASD 
See DASD Symptom Code Summary 
FILEDEFs for CPEREP 4-49 
using yourown 4-51 
files needed to run EREP under VM 
ACCDEV 4-50 
ACCIN 4-50 
DIRECTWK 4-50 
EREPPT 4-49 
SERLOG 4-50 
SYSIN 4-49 
TOURIST 4-50 
forcing CPU letter assignments 
See letter assignments for CPUs in EREP reports 


J 


frame records for 303X machine and channel 
checks 10-8, 20-4 


general information about EREP  1-1-1-15 
See also introduction to EREP 

General Input Facility 4-53 

getting a report from EREP 1-4 
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header for error records 10-10 
header record on ERDS 
See ERDS header record 
HIST processing parameter 1-12 
history data set 7-18, 9-4 
as input to EREP 1-7 
See also ACCIN input data set 
as output from EREP 1-6 
See also ACCDEV output data set 
containing frame records 20-5 
copying records from and to 4-12, 4-30, 4-47 
copying records from the ERDS_ 3-2 
DASD space required for work data set 4-18 
not the VSE history file 24-3 
other ways to use it 1-7, 17-4 
permanent 1-7, 3-3, 3-5 
how EREP assigns letters to CPUs in its reports 
See letter assignments for CPUs in EREP reports 
how EREP works 1-1 
how to add comments to EREP controls 7-3 
how to getan EREP report 1-4 
how torun EREP 1-3 
under MVS systems 1-3 
under VM systems 1-3 
under VSE systems 1-3 
how to use this book _ vii, viii 
how to use Part 1 1 
how to use Part 2 2-97 
how to use Part 3 5-5 
how to use Part 4 12-19 
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I/O subsystem exception reports 

See System Exception reports 
IFB010D, MVS system message 10-25 
IFC**** messages 

See EREP messages 
IFCDIPO0, OS/VS service aid 20-5, X-9 


IFCEREP1, EREP program name _ 1-3 
IFCOFFLD 3-3 
See also clearing the ERDS in an emergency 
IJSYSHF, VSE system history file 24-3 
IJSYSRC, VSE recorder file 10-1 
increasing storage to run EREP 
for MVS 4-34 
for VSE 4-16 
individual record summaries 
See Detail PRINT reports 
initializing LOGREC 24-5 
initializing SYSREC 24-2 
initializing the error-recording area 24-9 
input history data set 
See ACCIN input data set 
interpreting EREP reports, introduction to 2-92 
introduction to EREP  1-1-1-15 
ERDS — the error recording data set 1-1 
error recording area, for VM systems 1-1 
moving records from 1-7 
SYSREC, for VSE systems 1-1 
SYS1.LOGREC, for MVS systems 1-1 
EREP processing 1-2 
history data set 1-7 
how EREP works 1-1 
how yourunit 1-3 
input, the error records 1-1 
See also error records 
output from the program 1-3 
accumulated records 1-6 
descriptions and examples 2-1-2-96 
printed report 1-4 
TOURIST data 1-4 
purpose of EREP 1-1 
report output 1-4, 2-1-2-96 
what EREP requires of you 
data sets 1-15 
parameters and control statements 1-9 
system controls 1-14 
invalid parameter combinations (chart) 12-2 
IPL Detail Edit report example 2-89 
IPL Detail Summary report example 2-89 
IPL reason codes 
See IPL record 
IPL record 10-25 
format, on ERDS_ 10-26 
reason codes 10-27 
subsystem IDs 10-27 


JCL examples 
emergency offload of LOGREC 3-4 
sample MVS EREP runs 4-20-4-31 
JCS examples 
emergency offload of SYSREC 3-3 
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sample VSE EREP runs 4-2-4-13 
job control language (JCL) to run EREP under 
MVS 4-32-4-33 
job control statements (JCS) to run EREP under 
VSE 4-14-4-16 
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keyword parameters 
See EREP parameters 


learning about EREP  1-1-1-15 
See also introduction to EREP 
letter assignments for CPUs in EREP 
reports 2-92-2-94 
forcing, with SHARE statements 2-94 
sequence of 2-93 
LIA/LIBADR selection parameter 1-11, 7-19, 9-4 
LIMIT control statement 8-16, 8-17, 9-4 
brief description 1-13 
coding 8-17 
description 8-16 
examples 
for DASD 15-6 
for processors (CPU) 20-3 
for tape 17-6-17-7 
for processors and channels 20-2 
coding 20-3 
syntax 20-2 
valid keywords for 20-2 
valid machine numbers for 20-2 
for 33XX DASD 15-5 
coding 15-5 
examples 15-6, 15-7 
keyword values for 15-5 
syntax 15-5 
valid device/product types for 15-5 
for 34XX tape 17-4 
coding 17-6 
examples 17-6 
keyword values for 17-5 
syntax 17-5 
valid product/device types for 17-5 
3480 17-21 
coding 17-22 
keyword values for 17-21 
syntax 17-21 
general syntax 8-16 
limiting CPU exception report output 
See LIMIT control statement 
limiting temporary error output 
See LIMIT control statement 
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LINECT processing parameter 1-12, 7-20, 9-4 
listing of selected error record information 
See Event History report 
logical unit for EREP reports and messages 
See EREPPT and TOURIST entries 
See SYSLST logical unit 
LOGREC header 10-3 
long OBR records 
See OBR records 
Lost Record Detail Summary example (MVS) 2-88 
lost-record summary record 10-46 
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machine check record 
See MCH record 
magnetic tape drives 
See tape drives 
maintaining error data sets 
See managing error data for EREP 
managing error data for EREP 3-1 
clearing the ERDS in emergency 3-3 
consistency of input across reports 3-2 
creating a working copy of the ERDS 3-5 
integrity of data on the ERDS_ 3-1 
statistical data on the ERDS 3-6 
transferring data to another data set 3-5 
MCF records 10-8 
MCH Detail Edit report example 2-70 
MCH Detail Summary example 2-71 
MCH record 10-28 
format, on ERDS 
for MVS_ 10-34 
for non-MVS systems _ 10-30 
MDR Detail Edit report example 2-72 
MDR Detail Summary example 2-73 
MDR device type codes 12-16 
MDR record 10-35 
format, on ERDS 10-36 
MERGE processing parameter 1-12, 7-21, 9-4 
merging data from two systems 
See history data set 
message data set for EREP 
See TOURIST output data set 
message IFBOIOD 10-25 
messages 9-10, 11-1-11-46 
See also EREP messages 
messages from CMS/CPEREP 
See DMSIFC**** messages 
messages from EREP 
See EREP messages 
MIH Detail Edit report example 2-74 
MIH Detail Edit report example (370-XA) 2-75 
MIH Detail Summary example (370-XA) 2-75 
MIH Detail Summary report example 2-74 
MIH record 10-37 
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format, on ERDS 
recorded in 370 mode _ 10-38 
recorded in 370-KA mode 10-39 
miscellaneous data record 
See MDR record 
miscellaneous IBM products 
See other devices 
missing interrupt handler record 
See MIH record 
MOD selection parameter 1-11, 7-22, 9-5 
MODE selection parameter 1-11, 7-23 
modifying the EREP run 3-8 
multi-system complex and EREP 4-37, 24-6 
mutually exclusive EREP parameters (chart) 12-2 
MVS 
See MVS systems, defined 
MVS error recording data set 
See SYS1.LOGREC 
MVS notes 
access methods 4-36 
DCB requirements 4-36 
initializing LOGREC 24-5 
multiple history data sets 24-5 
software records 24-5 
MVS software error records 
See software error records 
MVS storage requirements 4-34 
MVS system termination record 
See Recovery/Termination record 
MVS systems 
access method used by EREP 4-36 
associated publications X-9, X-10 
automating the running of EREP 3-7 
coding EREP parameters and controls 7-3, 8-3 
combining input history data sets 24-5 
DCB requirements 4-36 
defined iii, X-2 
emergency offload of the ERDS 3-3, 3-4 
generalized problem determination tables 11-55 
increasing region size for EREP 4-34 
notes 4-36-4-37, 24-5 
reinitializing LOGREC 20-5 
required system controls (chart) 1-15 
sample EREP run 4-20-4-31 
sense data dumped to the ERDS_ 3-2, 3-6 
software records 24-5 
storage requirements for EREP 4-34-4-35 
system controls for EREP (JCL) 4-32-4-35 
writing sense data to LOGREC 3-2, 3-6 
MVS/XA 
See MVS systems, defined 


notes for MVS users 
See MVS notes 

notes for VM users 
See VM notes 

notes for VSE users 
See VSE notes 
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OBR Detail Edit report example 2-77 
OBR Detail Summary example 2-80 
OBR device type codes 12-13 
OBR records 10-41 
long form 10-41 
format, on ERDS_ 10-45 
short form 10-41 
format,on ERDS_ 10-42 
OBR/MDR Detail Summary example 2-81 
OCR/MICR devices 18-1 
product-specific information 18-1 
operating systems and EREP 
See also system control programs 
how EREP runs under _ 1-14 
increasing partition size, for VSE 4-16 
increasing region size, for MVS 4-34 
introduction 1-14 
storage requirements 1-14, 4-16 
for MVS 4-34 
for VSE 4-16 
usage notes 4-19 
for MVS 4-36, 24-5 
for VM 4-51 
for VSE 4-19, 24-3 
optical and magnetic-ink character readers 
See OCR/MICR devices 
OP77I, VSE message 4-19 
other devices 23-1 
product-specific information 23-1-23-2 
other publications X-9, X-11 
See also associated publications 
Outboard Environment Summary example 2-82 
outboard records 
See OBR records 
output data set for accumulated records 
See history data set 
output data set for an EREP report 
See EREPPT output data set 
output from the EREP program 
history data set 1-6 
See also history data set 
printed report 1-4 
See also EREPPT output data set 
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detailed descriptions and examples 2-1-2-96 
TOURIST data 1-4 
See also TOURIST output data set 
examples 8-14, 12-12 
output history data set 1-6 
See also history data set 


P| 


paper tape punches and readers 
See punched tape devices 
parameter delimiter (ENDPARM) | 1-13, 7-3, 8-3 
parameters and reports (chart) 7-4 
parameters for EREP 
See EREP parameters 
parameters that control IFCEREP!1 processing 
See EREP parameters 
parameters that request EREP reports 
See EREP parameters 
parameters that select records for EREP reports 
See EREP parameters 
permanent and temporary errors, defined 2-3, 2-35 
permanent error summary for tape 2-51 
planning checklist for running EREP 2-95 
planning for EREP  1-1-2-96 
checklist 2-95 
PRINT report parameter 1-10 
PRINT reports 
See Detail PRINT reports 
printers 19-1 
product-specific information 19-1-19-4 
problem determination tables 11-55 
processing parameters 1-9 
See also EREP parameters 
processor and channel keywords for LIMIT statement 
See coding the LIMIT statement for processors and 
channels 
processor error reporting, limiting 
See LIMIT control statement 
processor keywords for LIMIT statement 
See LIMIT control statement 
Processor Subsystem Exception report 2-21, 2-29 
See also System Exception reports 
processors 20-1 
product-specific information 20-1-20-11 
punched tape devices 21-1 
product-specific information 21-1 
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record for non-restartable wait 10-24 
record for restartable wait 10-24 
record type codes 10-11 
recorder file, for VSE systems 24-2 
See also SYSREC 
records used in each EREP report (table) 12-4 
Recovery/Termination record 
format, on ERPS 10-23 
reinitializing LOGREC 24-5 
reinitializing SYSREC 24-2 
reinitializing the error-recording area 24-9 
reliability data extractor (RDE) option 24-2 
report data set 
See EREPPT output data set 
report output from EREP 1-4 
report parameters 1-9 
See also EREP parameters 
report showing the record itself 
See Detail PRINT reports 
reports and valid selection parameters (chart) 7-4 
requirements for running EREP 
data sets 1-15 
parameters and controls 1-9 
system controls 1-14 
return codes from EREP processing 11-54 J 
running EREP in a multi-system complex 4-37 
recommended procedures for an MVS 
installation 24-6 
running EREP under MVS 4-20-4-31 
running EREP under VM 4-38, 4-48 
See also CPEREP command 
using CPEREP 9-8 
running EREP under VSE 4-2-4-13 


sample code for running EREP under MVS 
See running EREP under MVS 
sample code for running EREP under VM 
See running EREP under VM 
sample code for running EREP under VSE 
See running EREP under VSE 
sample EXECs for running EREP 4-38-4-48 
SCP 
See system control programs 
SCU Summary 
See DASD Storage Control Unit Summary 
selected information from error records 
See Event History report 
selecting records for reports 
See EREP parameters a 
selection parameters 1-9 
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See also EREP parameters 
valid for EREP report parameters (chart) 7-4 
serial OEM interface adapter 23-2 
setting limits for DASD report output 
See LIMIT control statement 
setting limits for tape report output 
See LIMIT control statement 
setting limits for 3480 report output 
See LIMIT control statement 
setting reporting limits for processor errors 
See LIMIT control statement 
setting up and running EREP 2-97 
examples of EREP runs 4-1 
under MVS 4-20-4-31 
under VM_ 4-38-4-48 
under VSE 4-2-4-13 
introduction 3-1 
maintaining error data 3-1 
See also managing error data for EREP 
SFT Detail Edit report example 2-87 
SFT Detail Summary example 2-88 
SHARE control statement 1-13, 8-18-8-21, 9-5 
description 8-18 
examples 8-19-8-21 
syntax 8-18 
to control CPU letter assignments in reports 2-92 
shared I/O: the multi-system environment 4-37, 24-6 
short OBR records 
See OBR records 
SHORT processing parameter 1-12, 7-26, 9-5 
SLH Detail Edit report example (370-XA) 2-84 
SLH Detail Summary example (370-XA) 2-85 
SLH record 10-48 
format, on ERDS 10-48 
software error records 10-46 
&12@soft. 
format, on ERDS_ 10-47 
format, on ERDS_ 10-47 
Software Recovery Status 20-7 
special considerations for EREP controls 
under VSE 4-19 
specifying EREP controls 6-4 
Stacking CPEREP operands 9-13 
standard header for error records 10-10 
statistical data on the ERDS 
added when you request certain reports 3-6 
storage capacities of various DASD (chart) 12-11 
Subchannel logout handler record 
See SLH record 
subsystem exception report series 
See System Exception reports 
subsystem IDs 
See IPL record 
summaries of DASD and tape subsystem errors 
See System Exception reports 
summary of all errors, all DP systems 
See System Summary report 
summary of errors on 34XX/8809 tape devices 
See Threshold Summary report 


summary of parameter defaults 12-9 
summary tables and charts 12-1-12-16 
SVC 76, to write records toan ERDS 24-8 
SYMCDE selection parameter 1-11, 7-27, 9-5 
syntax conventions for EREP parameters and control 
statements 6-1 
syntax summary charts 
for CPEREP operands 9-7 
for EREP control statements 8-22 
for EREP parameters 7-41 
SYSEXN report parameter 1-10 
SYSLST logical unit 1-15 
See also TOURIST output data set 
SYSREC 
format 10-3 
frame records on 20-4 
header record format, CKD devices 10-4 
header record format, FBA devices 10-5 
input for EREP 4-14 
other system files on 24-2 
reading records from 4-19 
reinitializing 20-5, 24-3 
Statistical data on 3-6, 4-19 
VSE system error data set 1-1 
SYSREC header 10-3 
system control programs 
See also entries under MVS, VM or VSE 
defined X-3 
product-specific information 24-1-24-10 
system controls for EREP 1-14 
different for each SCP, generally 1-14 
See also entries under each SCP 
under VM_ 1-14 
under VSE or MVS. 1-14 
system error log 1-1 
System Error Summary, Part 1 2-25 
System Error Summary, Part 2 2-27 
System Exception reports 7-28, 9-5 
Channel Subsystem Exception report 2-21 
DASD and tape summaries 2-22 
DASD Subsystem Exception report 2-21 
examples 2-23-2-57 
Channel Subsystem Exception report 2-30 
DASD Data Transfer Summary 2-43 
DASD informational messages 2-37 
DASD Storage Control Unit Summary 2-46 
DASD String Summary 2-38 
DASD Subsystem Exception report 2-32 
DASD Symptom Code Summary 2-40 
Processor Subsystem Exception report 2-29 
System Error Summary, Part 1 2-25 
System Error Summary, Part 2 2-27 
Tape DEVNO/CUA Statistics Summary 2-54 
Tape Permanent Error Summary 2-51 
Tape Subsystem Exception report 2-47 
Tape Temporary Error Summary 2-52 
Tape Volume Statistics Summary 2-56 
general description 2-20 
general formats 2-21-2-22 


Index X-21] 


introduction 2-20 
Processor Subsystem Exception report 2-21 
sample code for 2-23, 4-5, 4-23, 4-40 
selection parameters for 2-20 
Tape Subsystem Exception report 2-21 
System initialization Detail Edit example 
See IPL Detail Edit report example 
System initialization Detail Summary example 
See IPL Detail Summary report example 
system initialization reason codes 
See IPL record 
system initialization record 
See IPL record 
system initialization subsystem identifiers 
See IPL record 
system summary in chronological order 
See Trends report 
System Summary report 7-29, 9-5 
example 2-5-2-6 
general description 2-2-2-4 
introduction 2-2 
sample code for 2-4, 4-4, 4-20, 4-39 
selection parameters for 2-2 
System termination Detail Edit example 
See EOD Detail Edit report example 
System termination Detail Summary example 
See EOD Detail Summary report example 
System/370 iv, 1-1, 4-1 
SYSUM report parameter 1-10 
SYS1.LOGREC 1-1 
clearing, in emergency 3-4, 
format 10-3 
frame records on 20-4, 24-5 
header record format and contents 10-6 
reading records from 4-32 
reinitializing 20-5, 24-5 
statistical data on 3-6 
SYS1.LOGREC header 10-3 


tables and charts, summary 
DASD storage capacities 12-11 
default values and actions for EREP 
parameters 12-9 
invalid EREP parameter combinations 12-2 
records used in each report 12-4 
selection parameters valid for reports 7-4 
TOURIST output - messages and EREP 
controls 12-12 
TABSIZE processing parameter 1-12, 7-30, 9-5 
Tape DEVNO/CUA Statistics Summary 2-54 
tape drives 17-1 
product-specific information 17-1-17-23 
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tape keywords for LIMIT statement 
See LIMIT control statement 
Tape Permanent Error Summary 2-51 
Tape Subsystem Exception report 2-21, 2-47 
See also System Exception reports 
tape summary, not System Exception series 
See Threshold Summary report 
Tape Temporary Error Summary 2-52 
Tape Volume Statistics Summary 2-56 
tape 181 and 182 for CPEREP 4-51 
teleprocessing devices 
See TP devices 
temporary error summary for tape 
See Tape Temporary Error Summary 
temporary error, defined 
See permanent and temporary errors, defined 
TERMINAL operand for CPEREP 9-2, 9-5 
termination forced by IOS (record) 10-24 
termination forced by MCH (record) 10-24 
TERMN selection parameter 1-11, 7-31, 9-5 
THRESHOLD report parameter 1-10 
Threshold Summary report 7-32, 7-33, 9-6 
example 2-60 
general description 2-58 
introduction 2-58 
sample code for 2-59, 4-7, 4-25, 4-42 
selection parameters for 2-58 
TIME selection parameter 1-11, 7-34, 9-6 
time-stamp record for IPL 10-8 
TOURIST messages 
See EREP messages 
See TOURIST output data set 
TOURIST output data set 1-4, 1-15 
an aid to problem determination 5-3 
contents 1-4 
examples 8-14, 12-12 
in VSE systems 1-4 
required system controls 
for MVS 4-33 
for VM_ 9-10 
for VSE 4-15 
use in setting up DASDID controls 8-9, 8-13 
TP access method OBR record 10-42, 10-44 
TP devices 22-1 
product-specific information 22-1-22-3 
transferring data to another data set 3-5 
Trends report 7-35, 9-6 
example 2-9 
general description 2-7-2-8 
introduction 2-7 
sample code for 2-8, 4-13, 4-31, 4-48 
selection parameters for 2-7 
TRENDS report parameter 1-10 
two-part summary of all errors 
See System Summary report 
type codes for records 10-11 
TYPE selection parameter 1-11, 7-36-7-37, 9-6 
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unit check record 10-42, 10-44 
Unknown Detail Edit report example 2-91 
Unknown Detail Summary report example 2-91 
Unknown or Unsupported Record Detail Edit example 
See Unknown Detail Edit report example 
Unknown or Unsupported Record Detail Summary 
example 
See Unknown Detail Summary report example 


valid device types for DASD LIMIT statement 
See LIMIT control statement 
valid device types for tape LIMIT statement 
See LIMIT control statement 
valid LIMIT keywords for processors and 
channels 20-2 
valid LIMIT keywords for tape 17-5 
valid LIMIT keywords for 3480 17-21 
valid selection parameters for EREP reports 
(chart) 7-4 
VM error-recording area header 10-3 
VM notes 4-51 
defining files 4-51 
use of tape addresses 181 and 182 4-51 
error recording 24-8 
initializing the error-recording area 24-9 
VM system controls and notes 4-49-4-52 
VM systems 
See also CPEREP command 
associated publications X-11 
automating the running of EREP 3-7 
defined iii, X-3 
emergency offload of the ERDS 3-3 
error recording 24-8-24-9 
initializing the error-recording area 24-9 
notes 4-51-4-52 
reinitializing the ERDS 20-5, 24-9 
required system controls (chart) 1-15 
sample EREP run 4-38-4-48 
sense data dumped to the ERDS_ 3-2, 3-6 
source of input records 24-9 
system controls 4-49 
VM/370, VM/SP, VM/SP/HPO, VM/XA 
See VM systems, defined 
VOLID selection parameter 1-11, 7-38, 9-6 
volume statistics for tape 
See Tape Volume Statistics Summary 
VSE error recording data set 
See SYSREC 
VSE notes 4-19, 24-3 
access methods 4-19 
initializing the ERDS 24-2 


software records 24-2 

special considerations for EREP controls 4-19 
VSE storage requirements for EREP 4-16 
VSE system controls 4-14-4-18 
VSE systems 

associated publications X-9 

automating the running of EREP 3-7 

current level of EREP support iu, 24-2 

defined iii, X-1, X-3 

emergency offload of the ERDS 3-3 

generalized problem determination tables 11-55 

initializing SYSREC 24-2 

notes 4-19, 24-3 

RDE option 24-2 

reinitializing SYSREC 24-3 

required system controls (chart) 1-15 

sample EREP run 4-2-4-13 

software records 24-2 

storage requirements 4-16 

system controls 4-14, 4-18 

writing sense data to the ERDS 3-2 
VSE/Advanced Functions 

See VSE systems, defined 


where error records come from 1-1 
work data set for history input 

See DIRECTWK data set 
working copy of the ERDS, creating 3-5 


XA version of CCH record 
See CRW and SLH records 


ZERO processing parameter 1-12, 7-39-7-40, 9-6 


Numerics 


3090 Processor 

product-specific information 20-7 
3090 Vector Facility 

product-specific information 20-10 
33XX DASD subsystem summary 

See System Exception reports 
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3380 DASD 

product-specific information 15-8-15-10 
34XX tape subsystem summary 

See System Exception reports 
34XX/8809 tape summary 

See Threshold Summary report 
3422 Tape Subsystem 

product-specific information 17-8 
3480 keywords for LIMIT statement 

See LIMIT control statement 
3480 Tape Subsystem 
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report examples 17-12-17-20 
3820 printer 

product-specific information 
9332 and 9335 DASD 

product-specific information 
9347 Magnetic Tape Drive 

product-specific information 
9373, 9375 and 9377 Processors 

product-specific information 
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